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Preface 



Objectives 

This guide tells you how to manage a RSTS/E system on a day-to-day 
basis. To use the features that this guide describes, RSTS/E requires 
you to have certain privileges. Only the RSTS/E system manager and 
users with the needed privileges should have access to this guide. 

Audience 

This guide is primarily for use by system managers and operators. You 
do not need to have a great deal of knowledge and experience about 
RSTS/E to manage a RSTS/E system. However, to perform certain system 
management tasks, you should understand how to use a text editor like 
EDT and should be familiar with the DIGITAL Command Language (DCL). 

In addition, because not all customers install their own systems, the 
manual includes information for DIGITAL field service engineers and 
software support representatives. This information is clearly 
indicated. 



Document Structure 

This manual contains 16 chapters and six appendixes: 

Chapter 1 Contains a glossary of RSTS/E terms and an overview of the 
RSTS/E disk structures, system management concepts, 
multiple privileges, account management, and file access. 

Chapter 2 Describes procedures for starting, halting, and restarting 
RSTS/E. 

Chapter 3 Describes what you should include in the system start-up 
command file. 

Chapter 4 Describes the phases that you need to process when 
shutting down the RSTS/E system. 

Chapter 5 Explains the quotas that you can use to limit the amount 
of various system resources that users can have. 

Chapter 6 Describes the privileges that you can assign to a user 
when you create an account. 
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Chapter 7 

Chapter 8 
Chapter 9 

Chapter 10 
Chapter 11 

Chapter 12 

Chapter 13 

Chapter 14 
Chapter 15 

Chapter 16 

Appendix A 
Appendix B 

Appendix C 

Appendix D 

Appendix E 



Gives background information on managing RSTS/E accounts 
and then describes the DCL commands that you use to create 
and maintain the accounts. 

Gives background information on managing terminals and 
then describes the DCL commands that you can use. 

Gives background information on the Print/Batch Services 
(PBS) Package and then describes the DCL commands for 
using PBS. 

Describes the programs and DCL commands that are available 
to help you manage system errors. 

Introduces the concepts of device management and caching 
control on your RSTS/E system and then describes the DCL 
commands that you can use. 

Gives background information on RSTS/E system files and 
logical names and then describes the DCL commands that you 
can use to manage them. 

Gives background information on RSTS/E jobs and then 
describes the DCL commands that you can use to manage 
them. 

Describes miscellaneous DCL commands that you can use to 
manage your RSTS/E system. 

Gives background information on working with disks and 
tapes and then describes the DCL commands that you can use 
to manage them. 

Describes the DCL commands that you can use to back up and 
restore disk files and accounts. 

Describes the OPSER-based spooling package. 

Lists the octal and decimal values of each bit in the 
PDP-11 word. 

Lists the cluster size and total size of each disk that 
RSTS/E supports. 

Lists the general RSTS/E messages that you may encounter 
when using your RSTS/E system. 

Describes the SAVE/RESTORE system program for copying and 
backing up disks. 
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Appendix F Describes the Device Testing Package (DEVTST) that you can 
use to verify the reliability of RSTS/E supported 
hardware . 



Related Documentation 

As system manager you are responsible for setting certain parameters 
that affect the monitor and, consequently, the monitor directives. 
You also need to make decisions related to the installation and 
updating of your RSTS/E system. For more information on these topics, 
refer to: 

RSTS/E System Installation and Update Guide 
RSTS/E System Directives Manual 
RSTS/E Programming Manual 

For more information on RSTS/E documentation, consult the RSTS/E 
Documentation Directory . 

In addition to the RSTS/E documentation, you should have access to the 
following manuals: 

PDP-11 Peripherals Handbook 

DECnet/E System Manager ' s Guide 



Conventions 

Symbols and other conventions represent keyboard characters, or aid in 
the presentation of information. This guide uses the following 
symbols and conventions: 



<RET> 



Represents a car riage - return/line - feed 
combination. Press the RETURN key on your 
keyboard to produce this combination. 



<LF> 



Represents a line-feed character. Press the LINE 
FEED key on your keyboard to produce this 
character . 



<CTRL/x> 



Represents the CTRL key and some other character, 
represented here by x. For example, enter 
<CTRL/U> by holding down the CTRL key and pressing 
the keyboard key labeled "U" . RSTS echoes or 
displays the character at your terminal as "U. 



xix 



color In examples, black characters are data produced by 

the computer. 

Red characters indicate information that you type. 

[ ] Square brackets show the optional parts of a 

command in format statements. For example: 

DIRECTORY [ file - spec [,...] ] 

The optional parts of the command let you include 
a file specification ([ file - spec ]) , or more than 
one ([/...])/ if you choose. 

Square brackets also indicate the choice you have 
in using a command. For example: 

/[ NO ] DELETE 

This means you can type either /DELETE or 
/NODELETE, depending on the form of the qualifier 
you select. 



xx 



Summary of Technical Changes 

The RSTS/E System Manager ' s Guide contains revisions and updates to 
reflect the hardware and software that RSTS/E currently supports. 
Wherever possible, the examples use the new DCL commands. 

The significant changes for RSTS/E are: 

o The default keyboard monitor is DCL 

o Additional Quotas (see Chapter 5) 

o Multiple Privileges (see Chapter 6) 

o Account Management (see Chapter 7) 

o Terminal Management (see Chapter 8) 

o Print/Batch Services (see Chapter 9) 

o Backing Up and Restoring Files (see Chapter 16) 

o Other Miscellaneous System Management Changes (see Chapters 
11-14) 

Several utility programs formerly described in this manual are now in 
the RSTS/E Utilities Reference Manual. They are: 



o 


CPATCH 


o 


GRIPE 


o 


ODT 


o 


ONLPAT 


o 


RESTOR 


o 


TALK 



Also, the information on updating the RSTS/E software is now in the 
RSTS/E System Installation and Update Manual. 



xxi 



Chapter 1 

Overview of RSTS/E System Management 



RSTS/E runs on a PDP-11 computer. RSTS/E allows simultaneous, 
time-shared access to PDP-11 hardware and to RSTS/E software 
components through either local or remote asynchronous terminals. The 
RSTS/E Software Product Descr iption , which is part of the RSTS/E media 
kit, describes the hardware and software RSTS/E supports. This guide 
describes the software a system manager uses to control the operation 
of a RSTS/E system. The following sections introduce you to some 
important RSTS/E concepts. 



Glossary of RSTS/E Terms 

To understand how RSTS/E works, you need to know these terms: 



CCL (Concise Command Language) 

A concise way to run a RSTS/E system program. The CCL syntax 
lets you run a program without the RUN command and, unlike the 
RUN command, lets you place the entire command on one line. 
After the program completes executing, control returns to your 
job keyboard monitor. The system manager chooses the CCL 
commands for a particular RSTS/E system. In DCL, CCL's are 
defined using the DEFINE/COMMAND/SYSTEM command (see Chapter 12). 

DCL (DIGITAL Command Language) 

A set of commands available on many different DIGITAL systems. 
These commands perform basic tasks like copying files, printing 
files, and running programs. On RSTS/E, the DCL run-time system 
manages the DCL command environment. See the RSTS/E System 
User's Guide for more information about DCL on RSTS/E. See the 
RSTS/E Quick Reference Guide for a complete list of all DCL 
commands available on RSTS/E. 
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Default Keyboard Monitor 

The main keyboard monitor that you work with on a RSTS/E system. 
You enter the default keyboard monitor after you log in. The 
default keyboard monitor is DCL. 

Job 

The unit that RSTS/E uses to keep track of you (and other users) 
during a terminal session. When you log in, the system creates a 
job for you and assigns it a job number. The system uses your 
job number to keep track of everything you do from the beginning 
to the end of your terminal session. 

Job Keyboard Monitor 

The keyboard monitor that manages a job. Your job keyboard 
monitor is the same as the default keyboard monitor, unless you 
decide to change it with the SWITCH program. After you change 
your job keyboard monitor, you remain under its control until you • 
log out or use SWITCH again to change your keyboard monitor. 

Keyboard Monitor 

The part of a run-time system which interprets keyboard commands. 
When you work in the DIGITAL Command Language (DCL) environment, 
for example, you type commands that the DCL keyboard monitor 
receives and interprets. Each RSTS/E keyboard monitor has an 
identifying "prompt" that it displays to indicate when it expects 
command input. Common keyboard monitor prompts on RSTS/E are: 
dollar sign ($) for DCL; "Ready" for BASIC-PLUS; angle bracket 
(>) for RSX; and period (.) for RTll. 

Monitor or Executive 

The master control system software that observes, supervises, 
controls or verifies the operation of a computer system. The 
collection of routines that controls the operation of user and 
system programs, schedules operations, allocates resources, and 
performs I/O. 

Operating System 

The collection of programs, including a monitor or executive and 
system programs, that organizes a central processor and 
peripheral devices into a working unit for the development and 
execution of application programs. 
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Primary Run-Time System 

The run-time system that is permanently resident and that was 
installed when you established the defaults for your current 
monitor. The primary run-time system must be RSX or DCL. 

Program Development 

The process of writing, entering, translating, and debugging 
source programs. 

Public Structure 

The set of all disks that are public. When you do not include a 
device name in your file specification, the system by default 
accesses one of the disks on the public structure. The device 
name SY: represents the name for all disks in the public 
structure. Thus, if you do not have any public disks other than 
the system disk, SYO : and SY: are equivalents. If you have more 
than the system disk in the public structure, SY: refers to the 
aggregate of all public disks. SYO: refers to the system disk. 

Run-Time System 

System software that manages part of the RSTS/E system. For 
example, the BASIC-PLUS run-time system manages the BASIC-PLUS 
programming environment. The run-time system controls the 
interaction between a user or program and the monitor. 

System Disk 

The disk required by the RSTS/E monitor to start the system and 
to allow the system to run properly under timesharing. RSTS/E 
assigns device name SYO: to the system disk. 

System Program 

Any general - purpose program included in an operating system to 
perform common functions. CUSP is an acronym for Commonly Used 
System Program. 



System Management 

Management of RSTS/E begins with providing a properly tailored 
hardware and software configuration, proceeds through initializing the 
software at system installation time, and continues with the daily 
functioning of timesharing. To make sure you perform these steps 
efficiently, you should be familiar with time-sharing concepts and 
practices or have a close working relationship with a senior 
programmer or analyst experienced with time-sharing systems. 
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To manage a system well, you should know the processing requirements 
of the system and also its capabilities and structure. Information in 
the RSTS/E System Installation and Update Guide describes important 
aspects of hardware and software options and provides memory 
requirements to assist in configuring a RSTS/E system. 

As the system manager, you should be particularly careful about 
initializing your system for the first time. Because there are so 
many variables, no prepackaged approach can give you a completely 
optimized RSTS/E system. The RSTS/E System Installation and Update 
Guide provides detailed information about all the initialization 
options . 

To make sure that important information reaches the right persons 
within your organization, you should make someone responsible for 
current documentation of the system. This responsibility includes 
both locally generated and DIGITAL - suppl ied procedures and guides. 
The responsible person should make sure that specified members of the 
staff receive the most current system information. In too many cases, 
improper use of resources occurs when responsible individuals do not 
have the latest information. 



Disk Organization 

System managers should understand that the organization of files on 
disks is important. Only with this knowledge can you make the best 
use of all system resources. The following section introduces you to 
the concepts of disk and file structures and how to use them to best 
advantage. 



Types of Disks 

RSTS/E supports two types of disks as part of its logical disk 
structure: private and public. The public disk structure consists of 
a system disk (the one that was booted and contains the RSTS/E 
monitor) and additional public disk packs or disk cartridges. The 
system disk must be physically on line and logically mounted whenever 
the system is running; this way, users can gain access to the system 
disk during time-sharing operations. All other public disks that 
users may need to access must be physically on line and logically 
mounted . 

The system disk contains: 
o Monitor code 
o Initialization code 
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o The primary run-time system and the default keyboard monitor 
(DCL) 

o The command files for system start-up and crash recovery 

Some installations may also use the system disk for storing active 
user jobs that are temporarily swapped out of memory. 

Remaining space on the public disk structure is used for: 

o Auxiliary run-time systems 

o Optional system files 

o System programs 

o User programs and data files 

You can use disk drives not devoted to the public structure for 
private disk packs or disk cartridges. Unlike public disks, you can 
logically and physically dismount and move private disks to other 
drives during time-sharing operations. In addition, private disks 
make it possible to restrict disk storage to a defined set of users, 
which can be a distinct advantage when numerous projects are in 
progress. The file structure of a private disk is the same as that of 
a public disk. 

In addition to private and public disks, both of which any job on the 
system can share and access, you can logically mount a disk for use by 
only one job. In this case, only that job can access the disk. When 
the job terminates (for example, by logging out), the disk is 
logically dismounted. See "MOUNT for Disks" in Chapter 15. 



File Structures 

The RSTS/E file structures let the monitor access system and user data 
in an organized way. RSTS/E currently supports three kinds of file 
structures : 

o Level 0.0 -- Is for RSTS/E disks created before V8 . . You 
can mount disks with this structure as read-only, private 
disks. You cannot mount them as system or public disks. 

o Level 1.1 -- Is the structure created for V8 . . You can 

mount disks with this structure as read/write, private disks. 
You cannot mount them as system or public disks. 

o Level 1.2 -- Is the structure created for V9 . . You can 
mount disks with this structure as read/write, system, 
public, or private disks. 
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Note 

If you are upgrading a single disk RSTS/E system to 
V9 . , you can mount a Level 0.0 or Level 1.1 disk as 
the system disk. See the RSTS/E V9.0 Release Notes 
for information on how to convert your pre-V9.0 
system disk to the Level 1.2 structure. 

The following three sections describe the three kinds of structures. 
If you have a new RSTS/E V9 . system with all new disks, you can skip 
the sections that describe the disk structures before V9 . . 
Furthermore, if you have pre-V9.0 disks, DIGITAL recommends that you 
use the new DSKCVT disk conversion program to convert them to the new 
disk structure (see the RSTS/E System Installation and Update Guide). 

To see which structure applies to disks on your system, type SHOW 
DISKS as shown. The "Level" column indicates the RSTS/E disk 
structure level. For example: 

$ SHOW DISKS <RET> 



Disk Structure: 



Dsk 


Open 


Size 


Free 


Clu 


Err 


Name 


Level 


Comments 




DR1 


66 


131648 


29424 


22% 


4 





BOWER 


1.2 


Pub, DLW 




DR2 





. 242576 


33040 


13% 


8 





CRONIN 


0.0 


Pri, R-O, 


DLW 


DR3 


33 


500352 


57744 


11% 


8 





WOJTAS 


1.1 


Pri, DLW 




DR4 





242572 


17528 


7% 


4 





MODNE 


1.2 


Pri, DLW 




DR5 





500352 


76152 


15% 


8 





HOGAN 


0.0 


Pri, R-O, 


DLW 



$ 



Level Disk Structure (Pre-V8.0) 

Pre-V8.0 users gained access to files on a RSTS/E system by a Master 
File Directory (MFD) and by User File Directories (UFDs). Figure 1-1 
shows these structures. 
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MK-01 027-00 



Figure 1-1: MFDs and UFDs in Level File Structure 



As Figure 1-1 shows, each disk initialized for use on a RSTS/E system 
contains an MFD , located in [1,1]. The system uses the MFD to catalog 
other accounts on the disk. The MFD on the system disk lists the 
accounts that can be used to log in to the system. On a private disk, 
the MFD contains entries of accounts that can create files on that 
disk. Any user can access any file on any disk if the protection code 
of the file permits. Only users whose accounts are entered in the MFD 
on a private disk can create files on that disk. 

The system creates one UFD for each user account on a disk when the 
manager sets up the account (or, optionally, when a user creates the 
first file for the account). The UFD catalogs all program and data 
files under an account and maintains accounting and access information 
for these files. The UFD contains all retrieval information for the 
files because each file is pure data and has no linkage or structural 
information . 
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Level 1 Disk Structure (for V8.0 and V9 . ) 

In V8 . and V9 . , users access files on a RSTS/E system through the 
use of three structures: 

o A Master File Directory (MFD) 

o A Group File Directory (GFD) 

o A User File Directory (UFD) 

Figure 1-2 shows how these structures are related. 

UFDs Files 



GFDs 



MFD 



Contains pointers 

to GFDs by 
"direct access" 



[1/ 



[43,*] 



[100,*] 



[254/ 




[1,1] 



[1,25] 



[43,98] 




[100,60] 



[100,210] 



[254,254] 






MK-01 028-00 



Figure 1-2: MFD, GFDs, and UFDs in the Level 1 File Structure 



As Figure 1-2 shows, the MFD contains pointers to the Group File 
Directories (GFDs). The GFDs point to UFDs within each group. For 
example, a pointer in the MFD could access the GFD for files in [43,*] 
directories, from which it could access a specific UFD, such as 
[ 43,98 ] . 
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Differences Between Level 0, Level 1.1, and Level 1.2 

The new disk structure (Level 1.2) differs from the previous disk 
structures (Level and Level 1.1) in the following ways: 

o The account data on Level 1.2 contains attribute blockettes 
for the new or expanded attributes such as quotas, multiple 
privileges, and long passwords. 

o The MFD on Level 1.1 and Level 1.2 is not associated with an 
account number. 

On Level 0, the MFD was located in [1,1], and had to be at 
Block #1. Now, Block #1 points to the location of the MFD, 
allowing the MFD to be placed anywhere on the disk. 

o The MFD and GFDs on Level 1.1 and Level 1.2 do not store 
files . 

On Level 0, the MFD could store files as well as point to 
accounts . 

o GFDs on Level 1.1 and Level 1.2 allow more direct access to 
accounts . 

On Level 0, the MFD contained a linked list of pointers to 
all the UFDs. UFDs were listed in the order in which they 
were created with the REACT program; the MFD searched the 
list of directories in sequence until it located a UFD. 

Now, the MFD contains direct pointers to GFDs, which in turn 
point directly to any UFD. (However, the structure of the 
UFDs remains the same as in Level 0.) Thus, DCL commands that 
display accounts (for example, SHOW ACCOUNT) list the 
accounts in ascending order, rather than in order of 
creation . 

o You can create up to 65,025 accounts with the Level 1.1 or 
Level 1.2 structure. 

With the Level structure only 1735 accounts could be 
created and referenced on a disk. Now, you can create 
accounts for 255 groups, each with 255 users. Only the disk 
size restricts the number of accounts. 

The users on your system should not see the differences between the 
three structures. Level 1 takes up a little more disk space. There 
are more pointers, because each group is handled separately, but 
access to files is faster and the system can have more accounts. The 
linked list structure of the MFD is replaced by direct access to GFDs. 
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Disk Optimization 

When a user tries to access a file on the public structure, the system 
searches the directories on all disks that are part of the public 
structure. The search verifies whether the file exists. You can 
avoid the overhead of searching more than one disk by placing 
frequently accessed files on a private disk. This technique is valid 
for systems with a number of disks in the public structure, as well as 
for a system whose public structure consists of only one disk. The 
ability to place and preextend directories can also help you optimize 
disks (see Chapter 7). 

It is sometimes an advantage to dedicate an entire private disk to a 
single large production file. Such organization ensures an efficient 
directory structure and minimizes overhead to access file data. When 
more than one file is on the same private disk, it is best to dedicate 
a whole account to each production file. The system then spends less 
time searching the directory for file information. 

In general, you should keep volatile files and stable files in 
separate accounts to avoid fragmentation. Where file entries in the 
directory are spread across the face of the disk rather than being 
confined to a few sequential blocks, fragmentation requires the disk 
head to move more than is optimally efficient. Preextending 
directories can ensure that the directory is in sequential blocks (see 
Chapter 7). REORDR can restructure the directories on your system to 
improve disk access time (see Chapter 11). You can also optimize disk 
usage by separating frequently accessed files from those you use less 
often . 

In an environment where distinct data files must be accessed by the 
same program, the optimal organization is to keep each file on a 
different private disk. If a program must access more than one file 
on the same disk, overhead is increased because of disk-head movement. 
A large percentage of time is spent, therefore, in moving the head 
back and forth. However, if each file referenced by the program 
exists on a distinct private disk, head movement is not required 
whenever a program references another file. Head movement is 
restricted to locating the data itself. Positioning of directories 
can also help reduce head movement (see Chapter 7). 



System Operation Concepts 

Immediately after logging in to the system, a user's terminal is under 
the control of DCL (the system's default keyboard monitor). The 
terminal is said to be at the system command level because you can 
type a system command and the keyboard monitor processes it 
accordingly. The terminal returns to the system command level when a 
command or program completes executing, or when you enter a CTRL/C at 
the terminal. When the terminal is at the system command level, the 
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keyboard monitor examines each ASCII text line entered and determines 
whether that line is a system command. System commands are executed 
upon entry as described in the RSTS/E System User's Guide. 

The user job area is initialized at log-in time and set to a size of 
at least IK words (K = 1024). The job area can grow in increments of 
IK words to a maximum size set by the system manager at the start of 
time-sharing operations. The maximum size for any job image, 
including memory used by the current run-time system of the job, is 
64K words. This is the maximum size that the PDP-11 Instruction and 
Data (I&D) architecture (PDP-11/45,50,55,44,70,73) allows. For a 
PDP-11 without I&D architecture ( PDP - 11/23+ , 24 , 34 , 3 5 , 40 , 60 ) the 
maximum size is 32K words. 

Under the RSTS/E system, jobs run one at a time. A job runs until it 
enters an Input/Output (I/O) wait state or until it exhausts the time 
quantum assigned to it either by the system or the system manager. 
When the current job stops running, the scheduler runs the next job 
that is ready. Meanwhile, the inter rupt -driven I/O device handlers 
are processing requested data transfers. After completing a transfer, 
the scheduler marks the job that requested the transfer as ready to 
run again and starts it from the point at which execution stopped. 

RSTS/E tries to keep as many jobs in memory as possible. When a job 
requires more memory than is available, the system moves some jobs out 
of memory to temporary storage in one of up to four areas known as 
swap files. This operation is called swapping. By convention, these 
files are named SWAPO.SYS, SWAPl.SYS, SWAP. SYS, and SWAP 3 . SYS . When 
memory becomes available for a job stored in a swap file, it is 
swapped back into memory. Jobs waiting for keyboard input and jobs 
waiting for device I/O completion are most likely stored in the swap 
files, while jobs currently running or involved in disk or magnetic 
tape data transfers are stored in memory. 

As the system processes each job, it maintains accounting information 
in memory for that job. When the job is logged off the system, the 
information is used to update the accounting information stored on the 
system disk for that account. 



Privilege 

You must have a way to prevent general access to activities that can 
damage the system. The multiple privileges feature gives you finite 
control over access to activities. You can limit user access to just 
those activities suitable to each job. Multiple privileges gives you 
a tool to enhance both system performance and security. 
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Multiple Privileges 

The multiple privilege feature groups similar system functions into 
sets and defines a privilege to control access to each set of 
functions. A group of 34 privileges govern the entire set of RSTS/E 
system functions. The privileges given to an account determine the 
range of functions available to the user. Some privileges apply to 
very specific functions, while others control functions within broader 
classes of system use (see Chapter 6). 



Classes of System Activities 



The following sections divide some computer activities into general 
classes of system functions and discuss the privileges that control 
them. They describe: 

o Account Management Activities 

o File Access Activities 



Account Management Activities 

One general class of system activity is account management. A user 
accesses a computer through an account. The individual account is a 
member of a group, which contains all other accounts with the same 
project number. The group, in turn, is a subset of a world, which 
contains all accounts on the system. Account management activities 
include creating and deleting accounts, as well as changing passwords, 
disk quotas, and expiration dates. The following privileges control 
account management: 

GACNT Group Account Management - - Grants account management 

privileges within the user's group. 

WACNT World Account Management Grants account management 

privileges for all accounts. 

SETPAS Set Password Allows changing one's own password. 



File Access Activities 

Another general class of system activity is file access. Users 
routinely access files. Some files are created by the user and reside 
in the individual's account. Other files reside in the accounts of 
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other users or in system accounts. File access activities include 
creating, deleting, renaming, reading, writing, and executing files. 

Both the protection code of the file and the privileges granted to the 
user can affect whether the system grants or denies file access. 

In the case where no privileges are granted to a user, protection 
codes control the types of operations that a user can perform on a 
file. The SET PROTECTION command (or the /PROTECTION qualifier in the 
RSTS/E file specification) passes a value to the system that sets bits 
in the protection code byte. Each bit specifies that the activity 
named by that bit is prohibited or allowed. 

Certain privileges also govern file access activities. Some 
privileges override protection codes completely. The following 
privileges grant a user the right to perform certain file access 
activities, regardless of protection codes: 

GREAD Group Read -- Read any file within the group. Also, execute 

any program within the group, if the program's executable 
bit is set. 

WREAD World Read -- Read any file on the system. Also, execute 

any program on the system, if the program's executable bit 
is set. 

GWRITE Group Write -- Create, delete, extend, modify, or rename any 
file within the group. 

WWRITE World Write -- Create, delete, extend, modify, or rename any 
file on the system. 

Note 



In addition to WWRITE, you need SYSIO privilege to 
create, delete, extend, modify, or rename any file 
in group zero ([0,*]). 
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Multiple Privilege Masks 

You assign a certain set of privileges to each account. The system 
stores this set of privileges in privilege masks. A privilege mask is 
a set of flag bits with one bit corresponding to each privilege. 

For each active job, RSTS/E keeps 3 masks: 

o Authorized mask -- The set of privileges that you give to the 
account. Users can use the SHOW ACCOUNT/FULL command to list 
the set of privileges available to their own account. 

o Current mask -- The set of privileges now in effect for the 
job. The system always references this mask when it performs 
a privilege check. Users can raise or lower their privileges 
(up to their authorized limit) with the SET JOB/PRIVILEGE 
command . 

o Saved mask The saved record of the current privileges when 
a job gains temporary privileges (see the section "Temporary 
Privileges" ) . 

When a user attempts to perform an activity that is restricted by one 
or more privileges, the system performs a privilege check. It 
examines the current mask to determine if the requesting job has all 
the privileges required to perform the activity. If the requesting 
job has insufficient privilege to perform the activity, the system 
returns one of the following errors: 

o ?Protection violation 

o ?Illegal SYS() usage 

o PPrivilege XXXX required 
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Starting, Halting, and Automatic Recovery of RSTS/E 



This chapter describes how to start and halt a RSTS/E system and how 
the system recovers automatically from catastrophic system errors. 
This chapter also describes how to create the start-up conditions for 
a RSTS/E system. See the RSTS/E System Installation and Update Guide 
for a description of all other initialization code options and their 
functions . 



Starting up RSTS/E 

To start a RSTS/E system, you must first load into memory a program 
containing the initialization code (INIT.SYS) and then answer YES to 
the 'Start timesharing?' question. 

INIT.SYS is a large, stand-alone program that, once you transfer it 
from the RSTS/E distribution kit, exists on the system disk. INIT.SYS 
can provide a number of important system functions, such as: 

o Creating the RSTS/E file structure 

o Creating system files 

o Installing a RSTS/E monitor 

o Setting system defaults 

o Creating start-up conditions for RSTS/E 

INIT.SYS does some of these automatically; however, they can also be 
done through the Option: prompt. 

Before you can use the initialization code to start your RSTS/E 
system, you must move the code into memory. This is called 
bootstrapping. The following sections describe how to transfer the 
intial i zat ion code into memory. 
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Bootstrapping RSTS/E with a Hardware Bootstrap Loader 

The procedures for bootstrapping RSTS/E depend on the type of hardware 
bootstrap loader and the type of disk you use as the system device. 
You should make sure: 

o The system disk is physically mounted on a disk unit. 

o The drive on which the system disk is mounted has the READY 
light on and is in the WRITE ENABLE condition. 

o All required units are running and READY. 

o The console terminal is on line. 

Read the RSTS/E System Installation and Update Guide for the proper 
instructions on using the hardware bootstrap on your system. 

After you use the bootstrap to load the initialization code, INIT.SYS 
marks the successful completion of the bootstrap procedure by printing 
an identification line that includes the RSTS version number, the 
installation name, the disk unit bootstrapped, and the INIT version 
number, followed by the Current date prompt. Enter the date and press 
RETURN. INIT displays the Current time prompt. Enter the time and 
press RETURN. INIT displays the Start timesharing prompt. For 
example : 

RSTS V9.0 installation-name (DM0) INIT V9 . 

Current date <DD-MMM- YY>? 15 - Jan - 85<RET> 
Current time <HH : MM AM/PM>? 8:15 AM< RET> 

Start timesharing <Yes>? 

If the program does not print this information, make sure the console 
terminal is on line and try the operation again. If the system prints 
an error message on the console terminal, see the RSTS/E System 
Installation and Update Guide for recovery procedures. 

If you want to enable the automatic restart facility, set the CPU 
switch register so bit is ON. The automatic facility remains 
enabled as long as the CPU switch register remains set in this way. 
If your CPU does not have a switch register, the automatic restart 
facility is always enabled. 



Bootstrapping RSTS/E after a System Halt 

When a RSTS/E system halts as a result of a catastrophic error, RSTS/E 
displays the halt address in the address lights. For central 
processors that do not have console lights, for example the 
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11/23-PLUS, the 11/44, and CPUs with Remote Diagnostic Consoles 
(RDCs), the system prints the address on the console terminal. It is 
essential that you record this address. The exact procedure for 
examining memory locations depends on the type of processor and front 
panel of your system. Your DIGITAL Software Specialist can describe 
the procedure for your system. Once you record this information, 
bootstrap your system again using the procedures described in the 
previous section. See the section "Automatic Recovery and Restart 
Facilities" for a description of catastrophic errors, system crashes, 
and crash dumps. 



Starting Timesharing 

After you bootstrap the system disk, RSTS/E loads the initialization 
code (INIT.SYS) into memory. INIT then prints an identification line 
followed by the Start Timesharing <Yes>? prompt on the console 
terminal. You can answer in one of four ways: 

o Type YES or press RETURN to start the monitor named in the 
INIT logo 

o Type START monitor-name and press RETURN to install and start 
another monitor in [0,1] (not currently installed) 

o Type START and press RETURN to have INIT prompt you for a 
monitor name. For example: 

Monitor name to start <default name)? 

The default name is the name of the currently installed 
monitor, or the first Save Image Library (SIL) file found in 
the [0,1] directory. Press RETURN to start the named 
monitor. Type a question mark (?) character to have INIT 
display a directory of all SILs in [0,1]. 

o Type NO to have INIT proceed to the Option prompt. 

The program is ready to accept one of the options that Table 
2-1 summarizes. See the RSTS/E System Installation and 
Update Guide for a complete summary of these options. 
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Table 2-1: Initialization Option Summary 

+ + --..--- . + + 

I Option ! Abbreviation | Meaning | 



BOOT | 


BO 


| Bootstraps a magnetic tape or disk. 


COPY | 


CO 


| Transfers required files from the 

| Ul o Li 1UU L J.UH HltrUXUHl LU Ct o V o L C 111 Ulblv 

| and bootstraps the system disk. 


un 1 Hi 


Tift 


1 Resets me current, uate anu time . Also, 

establishes default date and time 
| formats. 


DEFAULT | 


DE 


| Establishes or changes a monitor's 
| start-up defaults such as the job and 

1 cwan may i Ttiiiin 

OWL* L> lUCl Jx X 111 La 1 11 . 


DSKINT | 


DS 


I Initializes and optionally formats a 
| disk. It also checks for bad blocks. 


HARDWR | 


HA 


| Specifies device controller 
| characteristics. 


IDENT | 


ID 


| Prints INIT.SYS creation date and a 
| list of patches. 


PATCH 


PA 


| Modifies RSTS/E system code to correct 
program errors and to add new program 
features. 


REFRESH | 


RE 


| Creates and positions system swap 

| files, adds bad blocks to the bad block 

| file, and positions optional system 

| files on the system disk or any 

| auxiliary disk. 


SAVRES | 


SA 


| Backs up (SAVE), reconstructs 
| (RESTORE), or makes an image copy 
(IMAGE) of a RSTS/E disk. 


START sil | 

i 


ST sil 


| Installs the specified Save Image 

| Library (SIL), assigns and checks 

| defaults, and starts the RSTS/E system. 

| If you do not enter a name for the SIL, 

| INIT prompts you for one. 
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Halting the RSTS/E System 

A system crash or setting the CPU console HALT/ENABLE switch to its 
HALT position causes a RSTS/E system to halt. RSTS/E considers the 
PDP-11/70 and PDP-11/45 to be in a halt state when both the RUN and 
PAUSE indicators on the CPU console panel are not lit. For 
PDP-11/23-PLUS and PDP-11/44 processors, the RUN light is off when the 
system is in a halt state. In all other cases, the CPU is running. 

The SHUTUP program shuts down the RSTS/E system. During this 
operation, SHUTUP makes sure all files are properly closed and that 
system accounting information is accurately updated. If you want to 
turn the power off, run SHUTUP, wait for INIT's Start timesharing? 
prompt, and press the HALT/ENABLE switch. See the section "Performing 
System Shutdown: SHUTUP" in Chapter 4 for a complete description of 
the SHUTUP program. 

DIGITAL recommends that you do not halt RSTS/E during timesharing by 
moving the HALT/ENABLE switch on the CPU console to its HALT position. 
If you do this during system shutdown, SHUTUP may not have completed 
clean-up operations; consequently, file data can become corrupted and 
accounting information may be lost. The only way to recover from such 
a halt and to salvage file information is to do the following: 

1. Raise the HALT/ENABLE switch back to its ENABLE position 
before you take any other action 

2. Press the CONT switch to return the RSTS/E system to the 
state it was in before the halt 



Automatic Recovery and Restart Facilities 

This section describes how catastrophic errors occur and how your 
system can automatically recover from them. The section also points 
out the need to include commands in the START.COM file to perform 
critical system operations when the system restarts in automatic mode. 



Catastrophic Errors and System Crashes 

Catastrophic errors and system crashes result from unexpected error 
traps. (For information on error traps, see the related processor 
handbook.) The processor can cause unexpected error traps when it: 

o Refers to a nonexistent or nonresponding memory address (for 
example, bus time-out trap) 
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o Refers to an odd address with an instruction that requires a 
word address 

o Attempts to execute a reserved or nonexistent instruction 

Also, if the monitor detects a condition which it knows should not 
normally occur, the monitor can force a software crash. Catastrophic 
errors and system crashes may occur as a result of three types of 
problems : 

o Privileged job programming errors 

RSTS/E system software is designed to protect itself against 
programming errors occurring in nonpr ivi leged jobs. When it 
detects such an error, the system aborts execution of the 
user request and returns a corresponding error message to the 
user's program. 

RSTS/E software is vulnerable to some types of errors caused 
by jobs with certain privileges. The privileges that require 
special caution are SYSIO, SYSMOD, and WRTNFS. Even though 
most errors do not cause the system to crash, you should take 
special care when programming with privileged system function 
calls such as Poke memory SYS call (SYS -6). See the RSTS/E 
Programming Manual . 

o Hardware malfunctions 

Hardware malfunctions can cause the system to crash. If 
system crashes or catastrophic errors occur that you cannot 
explain (particularly on systems that have traditionally been 
functioning well), it is likely that a hardware problem has 
occurred. You can diagnose hardware problems by examining 
the output logged by the programs in the RSTS/E System Error 
Package. See Chapter 10 for information on error logging. 

o System software malfunctions 

Although every attempt has been made to detect and eliminate 
system software errors, it is possible that RSTS/E software 
can crash unexpectedly. If a problem of this type is 
discovered (it should be reproducible in a defined 
environment and under defined conditions), contact a DIGITAL 
Software Specialist. As problems of this type become known, 
DIGITAL reports them in the "RSTS/E Software Dispatch" and 
corrects them as soon as possible. 
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Automatic Recovery from Catastrophic Errors 

The system takes action in one of two ways when an unexpected error 
trap occurs: 

o A catastrophic error that affects only one user 

o A system crash for which some software or hardware problem 
may be responsible 

For a catastrophic error, the system determines which user was 
responsible for the error. It flags the user's job with a special 
code; this causes the system to completely reinitialize that user's 
job area when it is the user's turn to run. The system prints an 
error message on the user's terminal, followed by the text: ??Program 
lost-sorry. The system resumes normal time-sharing operations. 

Note 

Some run-time systems may issue other error messages. 

When the system detects a condition from which it cannot recover, it 
does the following: 

1. Writes an image of read/write memory and tables to the 
CRASH. SYS file. 

2. Bootstraps the system disk. 

3. Loads the initialization code into memory. 

4. Rebuilds the system disk. 

5. Executes an automatic restart. (This occurs if the CPU 
switch register has bit set and if at least one minute has 
passed since start-up. ) 

If the CPU register does not have bit set or if one minute has not 
passed since start-up, the system does not perform an automatic 
restart. The system will only reboot; it will not restart. In other 
words, the automatic restart operation restarts timesharing using 
commands in the START.COM file. In contrast, a reboot merely loads 
the initialization code (INIT.SYS) into memory. INIT.SYS then prints 
its Start timesharing? <Yes> prompt, to which you can answer by typing 
any of the options in Table 2-1. 

If the system restarts automatically, it bootstraps itself into memory 
from the system disk. After the system is bootstrapped into memory, 
control passes to the initialization routines. The system recognizes 
start-up was through an automatic restart rather than through normal 
start-up. Consequently, the system initializes itself in automatic 
restart mode. If an error trap occurs within one minute of system 
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start-up or if two error traps occur within the same minute, the 
system halts at address 54. During automatic restart the system 
protects itself against an infinite loop or error traps and automatic 
restarts caused by a repeating hardware malfunction. 



Automatic Restart Mode Initialization 

When the system is initialized in automatic restart mode, control 
bypasses all parts of the initialization code that call for operator 
intervention and initializes the system using parameters specified at 
previous startup. The system: 

1. Logs job 1 in to the system on KBO: under account [1/2] 

2. Invokes [0,1] SYSINI . COM 

3. Executes [0,1] START . COM with the Pi argument set to 'CRASH' 
rather than 'START' 

4. Performs specific operations appropriate for an automatic 
restart 



Power-Fail Hardware Used by RSTS/E 

When power fails, a PDP-11 processor traps through the vector at 
location 24. When power is restored, you can configure the system to 
do one of three things: 

o Halt. 

o Boot a specific device. 

If the hardware is configured to boot the system disk, 
INIT.SYS prints its identification line and the Start 
timesharing <Yes>? prompt and wait for you to enter one of 
the options from Table 2-1. 

o Trap again through the vector at location 24. 

In this case, the system must have core memory or battery 
backup. If memory contents are still valid (which means the 
battery backup is not exhausted), RSTS/E performs an 
automatic restart. 
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This chapter describes how you control system start-up with the system 
start-up command file (START.COM). Start-up occurs when you answer 
YES to the Start timesharing <Yes>? prompt, use the START option of 
the initialization code, or when the system restarts automatically. 
At start-up, the monitor executes the command file [ , 1 ] SYSINI . COM 
which in turn executes [ , 1 ] START . COM . You can modify START.COM (but 
not SYSINI.COM) to suit the requirements of your installation. 

To control start-up efficiently, you should understand the conditions 
at start-up time: 

o Login attempts are prohibited (the monitor disables the login 
capability ) 

o The monitor logically mounts only the system disk read/write 

o No output is made to any terminal (except the console) 

o The monitor logs the console terminal KBO: into the system 
under the system library account [1,2] 

o The monitor assigns ALL privileges to this initial job 
regardless of the privileges assigned to account [1,2] 

o The monitor loads the DCL run-time system 

o The monitor starts execution of the command file 
_SYO: [0,1] SYSINI. COM at the console 



Creating and Using Command Files 

The SYSINI.COM command file contains commands necessary to initialize 
your RSTS/E system properly. This command file is reserved by 
DIGITAL; do not edit this file in any way. The START.COM file that 
comes with the RSTS/E distribution kit is a sample only; it may not 
execute properly on your system without modification. Make sure 
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START.COM includes the necessary commands to initialize your 
installation. Use a text editor on your system to modify the sample 
START.COM file supplied with the RSTS/E kit. 

Note 

Be sure both command files are in account [0,1] on 
the system disk. 



The start-up control file should perform the following operations: 

o Mount public and private disks 

o Assign system-wide logicals 

o Run the ERRINT program to start error logging 

o Enable data caching (if selected at system installation) 

o Set default system characteristics 

o Install run-time systems 

o Install libraries 

o Set terminal characteristics 

o Define CCL commands 

o Set printer characteristics 

o Start Print/Batch Services (PBS) package 

o Start OPSER-based spooling package (optional) 

o Start error analysis if needed 

o Enable logins 

o Logout the initial start-up job 

The order in which the operations are performed is critical. For 
example, mounting all public disks ensures the integrity of the public 
structure by making available all files on the system. You can mount 
any private disks in a similar manner. The various steps tailor the 
system according to your installation's requirements. 
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System Start-Up Command File: START.COM 

A complete system start-up command file contains the required commands 
to perform initialization for timesharing and to perform routine 
operations. The following sample shows a start-up command file: 

$ I 

$ 1 Pi - Type of startup (either START or CRASH) 
$ 1 
$ ! 

$ i *** prompt to continue *** 
$ ! 

$ S = "system startup" 

$ _if PI .eqs. "CRASH" then S = "crash restart" 

$ _inqui re/nopunc/exi t=END/time_out=10 GO "Proceed with ''S'? <YES>" 

$ __if f$instr(l,"YES" / f$edit(GO, -2) ) .eq. 1 then _goto START 

$END: 

$ _exit 

$ START: 

$ _open/logf ile/replace 'Pi'. LOG 
$ _set noecho/wa rning 
$ _set verify 
$ _write "" 

$ _write " Beginning RSTS/E ''S'..." 
$ __set noon 
$ I 

$ t *** Mount the Disks *** 
$ ! 

$ S = "" 

$ _if PI .eqs. "CRASH" then S = "and rebuilding " 

$ _write f$time()+" Mounting ''S'disks" 

$ ! (If this is a crash recovery, MOUNT will rebuild 

$ ! the disks if need be.) 

$ ! examples: 

$ ! $ mount/nowri te DR3 : LIBRAR L: 
$ ! $ mount DB2: LOOKUP 
$ I 

$ i *** Assign (or Replace) System-wide Logicals *** 
$ I 

$ __write f$time( ) + " Assigning logical names" 
$ I examples: 

$ I $ assign/system _SY:[2,9] FERN: 

$ ! $ assign/system/replace __DB2:[0,3] ERROR$ : 

$ ! 

$ i *** start Error Logging *** 
$ ! 

$ _write f$time()+ " Starting error logging" 
$ __set job/priority=0 

$ _if PI .nes. "CRASH" then _goto CONTl 

(continued on next page) 
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$ 

$ _run ERROR$ : ERRINT 

100 

YES 

$ __EOD 

$ _goto CONT2 

$CONTl : 

$ 

$ _run ERROR$ : ERRINT 

100 

NO 

$ _EOD 
$CONT2 : 

$ _set job/priori ty= - 8 
$ I 
$ 
$ 
$ 
$ 
$ 
$ 
§ 
$ 
$ 
$ 



If you have more than 128K you should 
replace the next line with 100/LOCK 



If you have more than 128K you should 
replace the next line with 100/LOCK 



*** Enable Caching and set Default System Characteristics *** 



_write f$time()+ " Setting system characteristics" 
___set cache/f ile/enable/keep=15/cluste rsize=2 
_set sy st em/da te_f ormat=alphabe tic 
_set system/time__f ormat=am_pm 
_set system/label=dos 
_set system/densi ty=1600 
_set system/name="EDERE" 
_set system/power fail_delay=300 
$ _set system/password_prompt=(network ,dialup) 
$ ! 

$ I *** Install the Run-time Systems and Libraries *** 
$ ! 
$ 
$ 



Installing run-time systems" 



write f $ time ( ) + 
_run $UTLMGR . TSK 
install/runtime_system BASIC 
install/runtime_system TECO$ : TECO 
install/library EDT$ : EDT 
install/library RMS$ : RMSRES 
install/library/noaddress RMS$ : RMSLBA 
install/library/noaddress RMS$ : RMSLBB 
install/library/noaddress RMS$ : RMSLBC 
install/library/noaddress RMS$ : RMSLBD 
install/library/noaddress RMS$ : RMSLBE 
install/library/noaddress RMS$ : RMSLBF 
install/library RMS$ : DAPRES 
$ _EOD 
$ ! 

$ ! *** Set Terminal Characteristics *** 
$ I 
$ 
$ 



_write f $time ( )+ 1 
_run $TERMGR . TSK 
set terminal kbO :/device_type=LA34/perm 
I Hard copy console 



Setting terminal characteristics" 



(continued on next page) 
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set terminal kbdO :/device__type=LAlOO/perm 

I Pseudo keyboard for batch 
iset terminal kbf :/speed=9600/device_type=VTl00/perm 

• DHO line as VT100 at 9600 baud 
Iset terminal kbgO :/speed=9600/device_type=VTl00/perm 

! DZO line as VT100 at 9600 baud 
!set terminal kbg8 :/speed=9600/device_type=VT240/perm 

! DZ1 line as VT240 at 9600 baud 

$ _EOD 
$ ! 

$ i *** Define System Commands *** 
$ ! 

$ _write f$time()+ " Defining system commands" 

$ ! Install system commands (CCLs) 

$ _run $UTLMGR . TSK 
define/command/system ATT-ACH $LOGIN.* /priv/linenumber=CCL 
define/command/system BCK - RMS$ : RMSBCK . TSK /linenumber=0 
define/command/system BPC-REF AUXLIB$ : BPCREF . * /linenumber=CCL 
define/command/system BYE- $LOGOUT.* /priv/linenumber=0 
define/command/system CCL- [ , 1 ]DCL.RTS /priv/linenumber=8192 
define/command/system DI -RECTORY $DIRECT . * /priv/linenumber=CCL 
define/command/system DSP- RMS$ : RMSDSP . TSK /linenumber=0 
define/command/system EDT - EDT$ : EDT . TSK /linenumber=0 
define/command/system FIT- AUXLIB$ : FIT . /pr iv/1 inenumber=CCL 
define/command/system HELLO- $LOGIN.* /pr iv/1 inenumber=0 
define/command/system HELP- HELP$ : HELP . * /priv/linenumber=CCL 
define/command/system I FL - RMS$ : RMSIFL . TSK /linenumber=0 
define/command/system LBR - $LBR . TSK /linenumber=0 
define/command/system LIBR - $LIBR.SAV /linenumber=8208 
define/command/system LIN- K $LINK.SAV /linenumber=8208 
define/command/system LOG- IN $LOGIN.* /pr iv/linenumber=0 
define/command/system MACR-0 $MACRO.SAV /linenumber=8216 
define/command/system MAC- $MAC.TSK /linenumber=0 
define/command/system MAK-E TECO$ : TECO . TEC /linenumber=3584 
define/command/system MU-NG TECO$ : TECO . TEC /linenumber=3584 
define/command/system PAT- $PAT.TSK /linenumber=0 
define/command/system PIP- $PIP.SAV /priv/linenumber=8208 
define/command/system RST- RMS$ : RMSRST . TSK /pr iv/linenumber=0 
define/command/system SUB-MIT $QUE.* /priv/linenumber=CCL 
define/command/system SW-ITCH $SWITCH.* /priv/linenumber=CCL 
define/command/system SY-STAT $ SYS TAT . * /priv/linenumber=CCL 
define/command/system TE-CO TECO$ : TECO . TEC /linenumber=3584 
define/command/system TKB - $TKB . TSK /linenumber=0 

$ _EOD 

$ I *** Set Printer Characteristics *** 
$ ! 

$ __write f$time()+ " Setting printer characteristics" 
$ ! examples: 

$ ! $ __set printer LP0 :/device_type=LPll 
$ ! $ __set printer LPl :/device_type=LAl80 
$ ! $ __set printer LP2 :/devi ce_type=LN01 

(continued on next page) 
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$ I *** Start Spoolers *** 
$ ! 

§ __write f$time()+ 11 Starting spoolers" 
$ ! Start PBS spooling package 
$ _start/queue/manager 
$ ! 

$ ! ** OPTIONAL** Start OPSER (old) spooling package 

$ ! 

$ _goto CONT3 I If OPSER is desired, delete this line. 
$ I Install related system commands 

$ _def ine/command/system PL-EASE OPSER$ : PLEASE . * /pr iv/line=CCL 

$ _def ine/command/system QU-EUE $QUE.* /pr iv/linenumber=CCL 

$ _run OPSER$:OPSER 

LOG OPSER$ :OPSER.LOG;ALL 

CHA KBO : 

MESS ALL 

OPER KB* : [ 1 , 2 ] 

DETACH 

$ _run OPSER$ : QUEMAN 

DETACH/PRI : 0/RUN : 6 

$ _set job/pr ior i ty= - 8 

$ _run OPSER$: SPOOL 

LPO : /HEAD : 2/RUN : 9/WIDTH : 8 

$ _set job/priori ty= - 8 

$ _run OPSER$: SPOOL 

LP1 : /HEAD: 1/RUN: 9/WIDTH: 132 

$ _set job/priority=-8 

$ _run OPSER$: BATCH 

BAO : /ERROR : FATAL/NOQUEUE/NODELETE 
$ __set job/priority=- 8 
§ _run OPSER$: BATCH 

BAl : /ERROR: FATAL/NOQUEUE/NODELETE 
$ _EOD 
$CONT3: 
$ ! 

$ I *** Start ANALYS if in Crash Recovery *** 
§ ! 

$ _if PI .nes. "CRASH" then _goto CONT4 

$ _write f$time( )+ " Starting analysis" 

$ _run ERROR$ : ANALYS 

[ 0,1 ] CRASH. SYS 

ERROR$ : ANALYS . DMP 

ERROR$ : ERRCRS . FIL/DET 

$ _EOD 

$CONT4: 

$ ! 

$ i *** Enable Logins *** 
$ I 

S __set system/logins 

$ _broadcast/all "RSTS/E is on the air..." 
$ __close/logf ile 

(continued on next page) 
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$ _set noverify 

$ _set echo 

$ _logout/br 
$ exit 



Note 

The start-up control files must be in [0,1] on the 
system disk (_SY0:, the disk that was bootstrapped). 



Mount All Disks 

To ensure the integrity of the public structure by making available 
all files on the system, you should mount all public disks. You can 
mount any private disks in a similar manner. If this is a restart 
from a system crash, MOUNT rebuilds the disks as required. See 
Chapter 15 for more information on mounting and initialization of 
disks . 



Assign System-Wide Logical Names 

You can assign a system-wide logical name to a specified device type, 
unit number, and PPN (optionally) with the ASSIGN/SYSTEM command. See 
Chapter 12 for more information on the use of system-wide logical 
names . 



Start Error Logging 

It is important that you run the ERRINT program on your system. This 
program sets initial conditions for system error logging and runs the 
ERRCPY program which transfers to a disk file all errors logged by the 
RSTS/E monitor. If ERRINT is the first program to be run (as DIGITAL 
recommends), it will occupy job number 1 on the system and thus be 
easily monitored. Chapter 10 describes ERRINT and ERRCPY. 

Note 

If your system has more than 128K words of memory, 
you should replace the first lines after the RUN 
ERRINT command lines with '100/LOCK' to keep ERRINT 
resident at all times. 
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Enable Caching (Optional) 

The SET CACHE/FILE/ENABLE command enables caching of data files whose 
UFD entry or OPEN MODE specifies caching. The /KEEP qualifier lets 
you specify the time that an unused cache cluster is kept in memory. 
The /CLUSTERSIZE qualifier controls the number of contiguous data ; 
blocks that are copied from the disk to the cache whenever file data 
is cached. Data caching is an optional feature that you can select at 
system installation. For more information on data and directory 
caching, see the section "SET CACHE Command and Qualifiers" in Chapter 
11 . 



Set Default System Characteristics 

The SET SYSTEM command sets the default system characteristics. In 
the sample START.COM, for example: 

o The date format is alphabetic 

o The time format is AM_PM 

o The magnetic tape label is DOS 

o The magnetic tape density is 1600 bpi 

o The system name is EDERE 

o The power fail delay is 300 seconds 

o NETWORK and DIALUP users must enter the system password 

See Chapter 14 for more information on setting system default 
characteristics. 

Install Run-Time Systems 

The INS TALL/RUNT I ME__SYSTEM command installs auxiliary run- time systems 
(like BASIC) in memory. See the section "Run- time System Control" in 
Chapter 12 for more information. 



Install Libraries 

The INSTALL/LIBRARY command installs resident libraries (like RMSRES) 
in memory. See Chapter 12 for more information on resident library 
control. 
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Set Terminal Characteristics 

At start-up time, the system sets the characteristics of all keyboard 
lines (except line number 0) to hard copy, 80 column output at the 
line speed of 300 baud. Thus, you need to use the SET TERMINAL 
command to set the correct characteristics of your terminals. Chapter 
8 contains detailed descriptions of the SET TERMINAL command 
qualifiers. 



Define System Commands 

It is most convenient to define Concise Command Language (CCL) system 
commands on the system at the start of timesharing using the 
DEFINE/COMMAND/SYSTEM command. The abbreviations shown in the 
definitions of the CCL commands reflect the way the RSTS/E 
documentation describes the commands. As the system manager you can 
redefine the abbreviations. You should not alter the fully defined 
command because each program is coded to recognize the fully expanded 
command . 

Note that the abbreviation point should be the same as the one used by 
DCL itself. For most DCL commands, the abbreviation point follows the 
second character, but for some, the abbreviation point follows the 
third or fourth character, to assure a unique abbreviation for each 
command . 

Use caution when you define system commands in this way. You may make 
features of other keyboard monitors unavailable. This may happen if, 
for example, you define PRINT as a CCL command. BASIC-PLUS users will 
then not be able to use the immediate mode PRINT statement. 

Two CCL commands duplicate commands the BASIC -PLUS keyboard monitor 
recognizes: HELLO and BYE. The commands are shown here to point out 
what BASIC-PLUS does by default. Other keyboard monitors may not 
recognize the commands HELLO and BYE if they do not exist as CCL 
commands . 

Each CCL definition requires one small buffer. The buffer will be 
allocated from the FIP small buffer pool. If this buffer pool is 
full, however, the monitor allocates the buffer for the CCL definition 
from the general buffer pool. See Chapter 12 for more information on 
the DEFINE/COMMAND/SYSTEM command. 



Set Printer Characteristics 

Just as you did for terminals, you need to set the characteristics of 
your printers. Minimally, you need to specify the device type of each 
printer on your system. See Chapter 11 for more information about the 
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qualifiers for the SET PRINTER command. 



Start Print/Batch Services 

The Print/Batch Services package (PBS) provides printing services for 
line printers or terminals, and batch processing. The package is 
started with a single command. Chapter 9 contains detailed 
descriptions of the DCL commands you can use to manage print/batch 
services . 



Start OPSER-Based Spooling Package (Optional) 

The OPSER-based spooling package like PBS provides print and batch 
services. RSTS/E offers this optional package for compatibility with 
previous versions of RSTS/E. New applications should use PBS. For 
more information on OPSER, see Appendix A of this manual and the 
RSTS/E Utilities Reference Manual. 



Start Error Analysis 

Run the ANALYS program immediately after a system crash to recover 
valuable diagnostic information. See Chapter 10 for a description of 
the ANALYS program. 



Enable Logins 

The SET SYSTEM/LOGINS command should appear after the commands that 
perform all required and routine operations. The SET SYSTEM/LOGINS 
command activates all swap space added on the system and lets users 
log in to the system. You can then notify users that timesharing has 
started. See Chapter 13 for more information on job management. 



Logout the Initial Start-Up Job 

You should always logout the initial start-up job, since it runs with 
ALL privileges. Failing to do so can create a security risk if the 
system console is left unattended. 
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Performing System Shutdown: SHUTUP 

The shutdown procedures for the RSTS/E system are critically 
important. If you are not careful in performing system shutdown, 
valuable user data can be irretrievably lost. To understand shutdown 
procedures fully, you need to understand other RSTS/E system 
procedures. Chapter 11 describes these concepts such as controlling 
logins, removing system files and resident libraries, sending messages 
to all logged-in users, and forcing commands to unresponsive 
terminals. 



Running SHUTUP 

You use the SHUTUP program to shut the system down in an orderly 
manner. SHUTUP is in the system library account $ ([1,2]). SHUTUP 
must be installed as a privileged program (protection code <232>). If 
not, the system displays the following error message: 

?Program must be privileged 

To run SHUTUP, you must have SHUTUP privilege. If you do not, the 
system displays the following error message: 

7SHUTUP privilege required 

Finally, SHUTUP can only be run from the system console ( KBO : ) . If 
not, the system displays the error message: 

7SHUTUP must be run from the system console (KBO:) 
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To verify that conditions are suitable for shutting down the RSTS/E 
system, use any of the SHOW commands, such as: 

o SHOW JOBS 

o SHOW DISKS 

o SHOW BUSY 

By executing these SHOW commands, you can determine what jobs are 
active on the system and what disks and other peripheral devices are 
in use. 



SHUTUP Phases 

As SHUTUP runs, it proceeds through the following 14 phases: 

1. Set-up dialogue 

2. Warning message 

3. DECnet/E shutdown (if necessary) 

4. Initial job killing 

5. Print/Batch Services (PBS) shutdown (if necessary) 

6. OPSER (optional spooling package) shutdown (if necessary) 

7. EVTLOG shutdown (if necessary) 

8. ERRCPY shutdown (if necessary) 

9. Final job killing (if necessary) 

10. EMT logging shutdown (if necessary) 

11. Unload and remove run- time systems and resident libraries 

12. Swap file removal 

13. Disk dismount 

14. Final shutdown 

The following sections describe these phases, the operator 
interactions required, and the expected results of the shutdown 
operation. Possible results, which you may not expect are also 
described. Several sample runs of SHUTUP show the results of shutting 
down the system. 
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Set-Up Dialogue Phase 

The set-up dialogue phase processes all questions relating to the 
selection of options in running SHUTUP. It also checks for the 
presence of PBS or OPSER. 

In response to questions that appear during this phase, you can press 
the circumflex ) key to return to the previous question. Otherwise, 
you should terminate your responses by pressing the RETURN key. 

If the Print/Batch Services (PBS) package is present, SHUTUP prints 
the following message: 

Allow 'PBS' entries to complete (YES/NO) <YES>? 

If you type NO, SHUTUP aborts all PBS entries that are in progress. 
If you press RETURN or type YES, SHUTUP lets all currently running PBS 
entries finish. 

If OPSER is present and running, SHUTUP prints the following question: 

Use 'OPSER' for utilities shutdown (YES/NO) <YES>? 

SHUTUP operates in either of two modes: 

o Without OPSER In this mode, regardless of whether OPSER is 
running, the SHUTUP program treats all jobs in the system 
alike during the shutdown procedure (except itself, the 
Print/Batch Services program, the DECnet/E EVTLOG program, 
the EMT logger program, and ERRCPY) . 

o With OPSER: In this mode SHUTUP allows OPSER to shut down its 
controlled jobs before SHUTUP continues with the regular 
shutdown procedures. 

You should be familiar with the OPSER program and how it controls 
various utility programs (such as QUMRUN and the OPSER spooling 
package programs). 

Press RETURN or type YES to have SHUTUP communicate with OPSER during 
the shutdown procedures. If you type NO, SHUTUP prints another 
question to confirm your response: 

Are you sure you don't want to use 'OPSER' (YES/NO) <NO>? 

Pressing RETURN or typing NO causes the program to repeat the previous 
question so you can again decide to use or not to use OPSER during 
shut down. Otherwise, the program ignores OPSER during the shutdown 
procedures . 
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If you choose to use the OPSER program, SHUTUP prints the following 
additional question: 

Allow utilities to reach logical end point (YES/NO) <YES>? 

If you press RETURN or type YES, the program directs OPSER to tell its 
online jobs to shut down their operations at the next logical 
breakpoint in their job streams. For a line printer spooler, for 
example, this breakpoint occurs between queued jobs. 

If you type NO, the program directs OPSER to tell its online jobs to 
abort and stop operations immediately. You should abort in this way 
only in an emergency: jobs being processed at the time of shutdown may 
be lost unless you have previously halted queuing and spooling 
operations and requeued these jobs. 

SHUTUP then asks you to specify the number of minutes you want to 
elapse before shutdown occurs: 

Minutes until system shutdown (0-99) <5>? 

This waiting period is called the "warning message phase" and may be 
as short as minutes or as long as 99 minutes. Press RETURN to 
select the default value of 5 minutes. If you decide to bring the 
system down immediately by typing 0, SHUTUP does not ask the two 
questions about disabling logins and the DECnet/E network. 

When you specify a shutdown period greater than minutes, SHUTUP 
allows you to select the amount of time that will elapse before 
further logins are disabled: 

Minutes until logins are disabled (0-99) <0>? 

This question gives you the opportunity to select the amount of time 
during which users can continue to log in to the system as shutdown 
occurs. Users can log in to the system (as if the system were not 
shutting down) for the number of minutes you specify. The ability to 
allow users this flexibility is useful when you specify a long 
shutdown period. 

There will be times when you do not want to allow any more users on 
the system. In this case, accept the default response by pressing 
RETURN. Then, users can no longer log in to the system; however, 
those already logged in remain unaffected. 

Note 

SHUTUP disables all logins at least one minute before 
the initial job killing phase. 
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The last message in the set-up dialogue phase allows you to choose the 
number of minutes that will elapse before new network activity is 
disabled: 

Minutes until new network activity is disabled (0-99) <nn>? 

The number of minutes SHUTUP selects for the default value <nn> 
depends on your response to the system shutdown question. As in the 
previous question, being able to specify when the network will shut 
down allows users time to complete network tasks. If you choose to 
allow no further logical links to be created, type 0, and then press 
RETURN. Those still using the network can continue to work but no new 
users are allowed access to the network. 



Warning Message Phase 

At the beginning of the warning message phase, as well as in the 
beginning of all other phases that SHUTUP may execute, a message 
appears on the system console terminal ( KBO : ) in the following format: 

hh:mm(AM)dd-mmm-yy ######## <phase title> ######## 
(PMj 

SHUTUP prints: 

o The time that it issues the message in the format hh:mm 
{AM | PM} 

o The date that it issues the message in the format dd-mmm-yy 

o The title of the current phase 

SHUTUP prints the following message on the system console terminal 
when the time specified for disabling logins has elapsed: 

Further LOGINS are now disabled 

The RSTS/E shutdown procedure requires that logins are disabled before 
the monitor can perform the final shutdown operation. During the 
following phases, SHUTUP continuously checks that logins remain 
disabled. If, for any reason, logins are not disabled, SHUTUP 
immediately aborts all operations with the following message: 

PLogins not disabled 

??SHUTUP aborting - please try again later 

You should determine the cause of the change, correct the problem, and 
run SHUTUP again. 
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If your system has DECnet/E support, the SHUTUP program prints the 
following message when the time specified for disabling network 
activity expires: 

Further network activity is now disabled 

The message tells you that no new logical links can be formed. Those 
links that are already active, however, can remain active until the 
time to network shutdown has elapsed. Before the network shuts down, 
the DECnet/E program EVTLOG may print messages indicating the status 
of the network. The initial EVTLOG message marks the beginning of the 
network shutdown phase. The second message, issued later in the 
shutdown process, indicates that the network has been shut off 
completely. See the section "SHUTUP Example: DECnet/E Shutdown" for 
an example of these messages. 

During the warning message phase, the program issues warning messages 
indicating the system is shutting down. These messages appear on most 
keyboards in the system, including pseudo keyboards. The following 
keyboards are the exceptions: 

OSC - The OPSER operator services console 
KBO : - The system console terminal 

The program issues warnings after an appropriate waiting period, 
defined by the following formula: 

waiting time = (total time left)/5 + 1 minutes 

For an initial waiting period of 60 minutes, warning messages appear 
at 60, 47, 37, 28, 22, 17, 13, 10, 7, 5, 3, 2, and 1 minute before 
shutdown begins. SHUTUP prints the following message on all system 
terminals at each warning time: 

hh:mm(AM) dd-mmm-yy System going down in n minutes, please finish up 
(PMJ 

At the same time, the following message appears on the system console 
terminal ( KBO : ) : 

n minute message sent 

When the time to shutdown has expired or if the initial waiting period 
is specified as 0, the final warning message appears: 

hh: mm (AM) dd-mmm-yy **** FINAL WARNING!!!!! System shutting down **** 
(PMJ 

At this point, the program enters the next phase. SHUTUP prints the 
time and date for both the SYSTEM GOING DOWN and the FINAL WARNING 
messages. 
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DECnet/E Shutdown Phase (When Necessary) 

The time to DECnet/E shutdown begins as soon as you enter the number 
of minutes that should elapse before new network activity is disabled: 

Minutes until new network activity is disabled (0-99) <nn>? 

The number of minutes, shown in angle brackets <nn>, is the default 
response. It assumes the same value you typed in response to the 
SHUTUP question: 

Minutes until system shutdown (0-99) <nn>? 

Rather than accept the default response (that is, to the network 
activity question) and have new network activity disabled at the same 
time the system shuts down, it is often better to disable new network 
activity before shutdown occurs. Entering a value less than the 
number of minutes to shutdown establishes a period before shutdown in 
which no new links can be created; it also allows time for those 
already active to complete network tasks. If you want new network 
activity disabled immediately, type and press RETURN. When the time 
to disable network activity has elapsed (0 to 99 minutes), SHUTUP 
prints a message to indicate no further network activity is allowed: 

Further network activity disabled 

SHUTUP disables new network activity by executing the equivalent of 
the Network Control Program (NCP) command SET EXECUTOR STATE SHUT. 
This prevents the creation of new logical links but does not affect 
existing logical links. In reality, a user can create new network 
links until the network activity is disabled. After that period ends, 
no new links can be created, but users already on the network can 
continue working until the system shuts down. The network remains up 
until there are no links active or until the system shuts down. 

As soon as all logical links have been disconnected by their users, 
the network state changes automatically to OFF. The state is 
immediately set to OFF if no links existed at the time SHUTUP disabled 
new network activity. If the DECnet/E event logging program EVTLOG is 
on and has event 2.0 enabled, it logs both the transition to SHUT and 
the one to OFF. (See the DECnet/E System Manager ' s Guide for a 
description of EVTLOG.) 

SHUTUP never sends special messages indicating the approach of a 
DECnet/E shutdown. Users can tell that SHUTUP is shutting down the 
system only from SHUTUP messages to all terminals and from the fact 
that the network is in the SHUT instead of the ON state. 

If the network has still not completely shut down at the end of the 
warning message phase (because active links remain), SHUTUP explicitly 
sets the network to OFF. This action disconnects all remaining 
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logical links. SHUTUP then waits 15 seconds to allow affected jobs to 
complete network tasks and exit, before it enters the job killing 
phase. 

If you decide not to shut the system down (thus, not shut off the 
network) after you have started SHUTUP, entering a CTRL/C to stop the 
execution of SHUTUP may reactivate the network. A CTRL/C causes 
SHUTUP to print a message telling you the state in which the network 
was left. If the network is not in the state you want, you must use 
NCP to place the network and the event logger (EVTLOG) in the desired 
state. See the DECnet/E System Manager ' s Guide for a description of 
NCP. 



Initial Job Killing Phase 

In the initial job killing phase, SHUTUP begins to clear the system of 
currently active jobs. If SHUTUP finds there is only one job (itself) 
running on the system, it skips this phase and then continues the 
shutdown procedure at the unload and remove run- time systems and 
resident libraries phase. 

If SHUTUP is using PBS in the next phase, during this phase the 
program ignores all jobs currently associated with PBS (as indicated 
by entries in PBS's on-line job table). The program also ignores any 
job whose primary keyboard is a pseudo keyboard. Such a job is 
probably being controlled by one of the batch servers. 

SHUTUP further divides all other jobs active in the system into two 
classes: attached and detached. This classification depends on 
whether they have an attached primary keyboard (KB:). For all 
attached jobs, SHUTUP forces the following text string to the keyboard 
input buffer: 

*C "C $ LOGOUT/BRIEF 

For all detached jobs, SHUTUP issues the Kill job SYS call (SYS 8) to 
remove the job. 

SHUTUP makes two passes through the current active job table during 
this phase. In the first pass, the program terminates all active jobs 
not being ignored. At the end of the first pass, it establishes the 
number of attached jobs that were found and forced to logout. SHUTUP 
then waits for a specified period to allow the LOGOUT program to 
complete operations on each of the attached jobs. 

After the waiting period (if any) expires, the program makes a second 
pass through the active job table. During this pass, all jobs not 
being ignored are removed with the kill job SYS call. At the end of 
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the pass, the program checks the table. If any jobs that should have 
been killed were not, SHUTUP aborts operations with the following 
error message: 

7SHUTUP failed in initial job killing phase 
??SHUTUP aborting - please try again later 

You should determine why SHUTUP could not kill all jobs, correct the 
problem, and run SHUTUP again. 

If SHUTUP successfully removes all jobs during the phase, or if at any 
time during either pass the number of active jobs becomes one (SHUTUP 
only), the next phase begins. 



Print/Batch Shutdown Phase (When Necessary) 

The program skips the Print/Batch Services (PBS) shutdown phase if PBS 
is not running on the system. If PBS is not running, SHUTUP continues 
with the next phase; no message is displayed. 

If PBS is running, SHUTUP sends a message to QMAN telling QMAN to 
shutdown PBS. QMAN acknowledges the shutdown command by sending back 
a confirmation message. If SHUTUP does not receive the confirmation 
message within two minutes after the offline request was sent, SHUTUP 
aborts the shutdown operation and displays the following: 

?No response from Print/Batch Services after 2 minutes 

Otherwise, SHUTUP displays the number of entries currently processing 
in PBS in the following format: 

Print/Batch Services shutting down # jobs are completing. 
Print/Batch Services shutting down -- # jobs are being terminated. 

Then SHUTUP waits for PBSMGR to shutdown PBS. The maximum wait period 
is one hour if jobs are allowed to complete and one minute if jobs are 
aborted. If shutdown occurs in the specified time, SHUTUP displays 
the following message and goes to the next phase: 

Print/Batch Services shutdown complete at hh:mm am/pm 

Otherwise, SHUTUP aborts and displays the following error message: 

?Print/Batch Services shutdown taking too long 
??SHUTUP aborting - please try again later 
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OPSER Shutdown Phase (When Necessary) 
The program skips the OPSER shutdown phase if: 
o OPSER is not running on the system 

o You elect not to use OPSER during the shutdown procedures 

If you choose to use OPSER, SHUTUP immediately detaches from the 
system console terminal ( KBO : ) to enable OPSER to reattach to the 
terminal for use during OPSER' s shutdown procedures. As the detach 
occurs, the following messages appear: 

DETACHING. . . 
'OPSER' ATTACHING 
# 

SHUTUP sends a message to OPSER directing it to begin its shutdown 
procedures by selecting the appropriate mode of OPSER shutdown. 
SHUTUP then waits 60 seconds to see if OPSER receives the message 
and/or is functioning properly. If OPSER does not respond properly 
within that time, SHUTUP attempts to reattach to the system console 
terminal (KBO:). If the operation is successful, the following 
message appears: 

?OPSER not active 

??SHUTUP aborting - please try again later 

If the terminal is attached or assigned, SHUTUP waits for one second 
and tries again. You should take whatever steps are necessary to free 
the system console terminal (KBO:) for use so SHUTUP can complete its 
activities . 

If OPSER is shutting down its online programs in the immediate mode, 
it sends each program the appropriate message to stop operations. 
OPSER pauses to make sure all programs have completed their 
assignments. OPSER then closes its files, prints the following 
message on the system console (KBO:), and stops execution: 

'OPSER' TERMINATING 

SHUTUP allows OPSER 120 seconds to complete its shutdown in the 
immediate shutdown mode. If unsuccessful, SHUTUP aborts its 
operations, signaling the failure as follows: 

?OPSER shutdown taking too long 

??SHUTUP aborting - please try again later 

If OPSER is shutting down in the logical end mode, it proceeds to 
shutdown successive levels in its online job table. Appropriate 
system console messages signal the end of each job (see "SHUTUP 
Operation Examples"). When all online OPSER jobs are gone, OPSER 
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closes its files and kills itself, freeing the system console for 
SHUTUP use again. OPSER tells you when it finishes processing with 
the message: 

'OPSER' TERMINATING 

SHUTUP allows 60 minutes in the logical end mode for OPSER to complete 
operations. If the procedure is not successful, SHUTUP aborts 
operations with the error message described previously. Otherwise, 
the shutdown of OPSER- related jobs and activities is complete and the 
program enters the next phase. 



EVTLOG Shutdown Phase (When Necessary) 

The SHUTUP program enters the EVTLOG shutdown phase if it finds EVTLOG 
in the message/receiver table. (DECnet/E does not need to be active 
for SHUTUP to perform this phase.) SHUTUP sends EVTLOG a special error 
message that causes EVTLOG to log the shutdown occurrence on the 
system console, perform various other shutdown operations, and kill 
itself. 

When SHUTUP detects that EVTLOG has completed its shutdown activities 
and is no longer present, SHUTUP proceeds to the next phase. SHUTUP 
allows 60 seconds for EVTLOG to complete its tasks, and if failure 
occurs, SHUTUP aborts operations with the following error message: 

? EVTLOG failed to shutdown 

??SHUTUP aborting - please try again later 

See the DECnet/E System Manager ' s Guide for information about the 
EVTLOG program. 



ERRCPY Shutdown Phase (When Necessary) 

The program enters the ERRCPY shutdown phase if the system error 
logging utility ERRCPY is present. SHUTUP sends ERRCPY a special 
message which causes ERRCPY to log the shutdown occurrence in the 
system error log, close the file, and kill itself. 

When SHUTUP detects that ERRCPY has completed its shutdown and is no 
longer present, SHUTUP proceeds to the next phase. SHUTUP allows 60 
seconds for ERRCPY to complete its tasks. If failure occurs, SHUTUP 
aborts operations with the following error message: 

7ERRCPY failed to shutdown 

??SHUTUP aborting - please try again later 
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Final Job Killing Phase (When Necessary) 

If SHUTUP reaches this point, and is not the only job left running in 
the system apart from the EMT logger, SHUTUP makes one last attempt at 
killing all other remaining jobs. If SHUTUP is successful, it enters 
the next phase. If not successful, SHUTUP aborts operations with the 
following error message: 

? SHUTUP failed in final job killing phase 
??SHUTUP aborting - please try again later 



EMT Logging Shutdown Phase (When Necessary) 

The program enters the EMT logging shutdown phase if the EMT logging 
utility is present. (See Chapter 14 for a description of the EMT 
logger.) SHUTUP sends a shutdown message to the EMT logger, informing 
the EMT logger to stop. If the EMT logger does not shut down in 60 
seconds, SHUTUP aborts the EMT logger with the following warning 
message : 

%EMT logger failed to shutdown - killing EMT logger job = n 
In this message, n is the job number of the EMT logger. 



Remove Run-Time Systems and Resident Libraries Phase 

During the remove run-time system arid resident libraries phase, the 
program removes all run-time systems and resident libraries from the 
system tables. SHUTUP does not attempt to remove the primary run- time 
system. 



Swap File Removal Phase 

During the swap file removal phase, SHUTUP makes sure all installed 
swap files are removed. 



Disk Dismount Phase 

During the dismount phase, the program dismounts all mounted disks, 
both private and public, from the system. The system disk always 
remains mounted. 
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If you have opened a file using the DCL commands OPEN or OPEN/LOG, or 
if you are executing SHUTUP from an indirect command file, and the 
file resides on a disk other than the system disk, an unexpected error 
occurs when SHUTUP tries to dismount the affected disk. SHUTUP aborts 
and you must close the file before retrying the shutdown. 



Final Shutdown Phase 

SHUTUP enters the final shutdown phase to output the last status 
message, clears the system console terminal ( KBO : ) buffers, and 
executes the special System shutdown SYS call (SYS -16). The monitor 
transfers control to the system initialization code (INIT.SYS) and 
bootstraps the system disk. The monitor loads the initialization code 
and INIT prints the Start Timesharing <Yes>? prompt. 



SHUTUP Operation Examples 

Each of the following sections contains an example of a SHUTUP 
operation. These examples and the description of the SHUTUP program 
should help you to shut down your system correctly and in orderly 
fashion. 



SHUTUP Example: Large RSTS/E System 

The system in the following example is being shut down in a leisurely 
fashion. This gives system and network users enough time to complete 
their tasks. SHUTUP allows users to log in to the system during the 
entire shutdown phase; logins are disabled at system shutdown, after 5 
minutes. Those using the network can log in until the 5-minute mark, 
after that time the system does not allow network access by users. 
However, those on the network before new network activity is disabled 
can continue to work until the system shuts down completely. 

$ run shutup 

SHUTUP V9.0 RSTS V9 . EDERE 

10:11 AM 28-May-85 ######## Set-up Dialogue Phase ######## 

Type ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 
Use OPSER for utilities shutdown <YES>? yes 

Allow OPSER utilities to reach logical end point <YES>? yes 
Minutes until system shutdown (0-99) <5>? 15 

(continued on next page) 
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Minutes until logins are disabled (0-99) <0>? 5 

Minutes until new network activity is disabled (0-99) <5>? 5 

10:12 AM 28-May-85 ######## Warning Message Phase ######## 

15 minute warning message sent 

11 minute warning message sent 

Further LOGINS are not disabled 

Further network activity is now disabled 

8 minute warning message sent 

6 minute warning message sent 

4 minute warning message sent 

3 minute warning message sent 

2 minute warning message sent 

1 minute warning message sent 

10:27 AM 28-May-85 ######## DECNET Shutdown Phase ######## 

10:27 AM 28-May-85 ######## Initial Job Killing Phase ######## 

10:27 AM 28-May-85 ######## Print/Batch Shutdown Phase ######## 
Print/Batch Services shutdown complete at 10:27 AM 

10:27 AM 28-May-85 ######## OPSER Shutdown Phase ######## 

Detaching . . . 



'OPSER' ATTACHING 
# 

JOB #6 'BA1SPL' TAKEN OFFLINE 
# 

JOB #7 ' BA2SPL ' TAKEN OFFLINE 
# 

JOB #5 'BA0SPL' TAKEN OFFLINE 
# 

JOB #4 'LP0SPL' TAKEN OFFLINE 
# 

JOB #3 'QUEMAN' TAKEN OFFLINE 
#' OPSER' TERMINATING 



Re - attaching . . . 
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85 


######## 
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######## 



EVTLOG Shutdown Phase ######## 

ERRCPY Shutdown Phase ######## 

Remove RTS/RES LIB Phase ######## 

SWAP File Removal Phase ######## 

Disk DISMOUNT Phase ######## 

Final Shutdown Phase ######## 

(continued on next page) 
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Please wait for system to re-boot itself 
RSTS V9.0 EDERE ( DRl ) INIT V9 . 
28 -May- 85 10:30 AM 
Start timesharing <Yes>? 



SHUTUP Example: Small RSTS/E System 



The following example shows a system shutdown when OPSER is not 
present. Except for the absence of the first OPSER- related question, 
the example applies when OPSER is present but not used during 
shutdown . 

$ run shutup 

SHUTUP V9.0 RSTS V9 . EDERE 



12:24 PM 22-May-85 ######## Set-up Dialogue Phase 

Type ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 
Minutes until system shutdown (0-99) <5>? 5 
Minutes until logins are disabled (0-99) <0>? 1 

12:24 PM 22-May-85 ######## Warning Message Phase 

5 minute warning message sent 

Further LOGINS are now disabled 

3 minute warning message sent 

2 minute warning message sent 

1 minute warning message sent 

12:24 PM 22-May-85 ######## Initial Job Killing Phase 

12:25 PM 22-May-85 ######## Print/Batch Shutdown Phase 
Print/Batch Services shutdown complete at 12:25 PM 



12:25 PM 22-May-85 ######## 

12:25 PM 22-May-85 ######## 

12:25 PM 22-May-85 ######## 

12:25 PM 22-May-85 ######## 

12:25 PM 22-May-85 ######## 



EVTLOG Shutdown Phase 
ERRCPY Shutdown Phase 
Remove RTS/RES LIB Phase 
SWAP File Removal Phase 
Disk DISMOUNT Phase 



######## 



######## 



######## 
######## 

######## 
######## 
######## 
######## 
######## 



(continued on next page 
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12:25 PM 22-May-85 ######## Final Shutdown Phase ######## 

Please wait for system to re-boot itself 
RSTS V9.0 EDERE ( DRl ) INIT V9 . 
22-May-85 - 12:24 PM 
Start timesharing <Yes>? 



SHUTUP Example: DECnet/E Shutdown 

This example shows SHUTUP when OPSER is used to shut down a spooling 
system of five spoolers. It also illustrates how the network shuts 
down when a system includes DECnet/E support and event logging by the 
DECnet/E EVTLOG program has been enabled. 

$ run shutup 

SHUTUP V9.0 RSTS V9 . EDERE 

12:39 PM 22-May-85 ######## Set-up Dialogue Phase ######## 

Type ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 

Use 'OPSER' for utilities shutdown <YES>? yes 

Allow OPSER utilities to reach logical end point <YES>? yes 

Minutes until system shutdown (0-99) <5>? 5 

Minutes until logins are disabled (0-99) <0>? 

Minutes until new network activity is disabled (0-99) <5>? 2 

12:40 PM 22-May-85 ######## Warning Message Phase ######## 

Further LOGINS are now disabled 
5 minute warning message sent 

Further network activity is now disabled 
3 minute warning message sent 

Event type 2.0, Local node state change 
Occurred 22-May-85 12:42:05.0 on node 135 (OTHG) 
Reason for state change: Operator command 
Old node state = On 
New node state = Off 

2 minute warning message sent 
1 minute warning message sent 

12:45 PM 22-May-85 ######## DECNET Shutdown Phase ######## 

(continued on next page) 
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12:45 PM 22-May-85 ######## Initial Job Killing Phase 

12:45 PM 22-May-85 ######## Print/Batch Shutdown Phase 
Print/Batch Services shutdown complete at 12:45 PM 



12:45 PM 22-May-85 ######## 
Detaching . . . 



OPSER Shutdown Phase 



######## 
######## 

######## 



'OPSER' ATTACHING 
# 

JOB #6 'BAlSPL' TAKEN OFFLINE 
# 

JOB #7 ' BA2SPL ' TAKEN OFFLINE 
# 

JOB #5 'BAOSPL' TAKEN OFFLINE 
# 

MESSAGE 949 : 22 -May- 85 12:45 PM JOB: 3 DET QUMRUN[1,2] 

BA1SPL (6) REQUESTED OFF-LINE -- TAKEN OFF-LINE 

# 

MESSAGE 950 : 22 -May- 85 12:45 PM JOB: 3 DET QUMRUN[1,2] 

BA2SPL (7) REQUESTED OFF-LINE -- TAKEN OFF-LINE 

# 

MESSAGE 951 : 22 -May- 85 12:45 PM JOB : 3 DET QUMRUN[1,2] 

BAOSPL (5) REQUESTED OFF-LINE -- TAKEN OFF-LINE 

# 

JOB #4 'LPOSPL' TAKEN OFFLINE 
# 

MESSAGE 952 : 22-May-85 12:45 PM JOB : 3 DET QUMRUN[1,2] 

LPOSPL (4) REQUESTED OFF-LINE -- TAKEN OFF-LINE 

# 

JOB #3 'QUEMAN' TAKEN OFFLINE 
# 'OPSER' TERMINATING 

Re -attaching ... 



12 


:45 


PM 


22 


-May- 


85 


######## 


EVTLOG Shutdown Phase 


######## 


Shutting 


down EVTLOG 


r by operator 


request . 




12 


:45 


PM 


22 


-May- 


85 


######## 


ERRCPY Shutdown Phase 


######## 


12 


:45 


PM 


22 


- May - 


85 


######## 


Final Job Killing Phase 


######*'# 


12 


:45 


PM 


22 


-May- 


85 


######## 


Remove RTS/RES LIB Phase 


######## 


12 


:45 


PM 


22 


-May- 


85 


######## 


SWAP File Removal Phase 


######## 


12 


:45 


PM 


22 


- May - 


85 


######## 


Disk DISMOUNT Phase 


######## 


12 


:45 


PM 


22 


-May- 


85 


######## 


Final Shutdown Phase 

(continued on 


######## 
next page) 
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Please wait for system to re-boot itself 
RSTS V9.0 EDERE ( DRl ) INIT V9 . 
22 -May-85 -12:45 PM 
Start timesharing <Yes>? 



Notes on SHUTUP Operation 

You can help the users on your system by establishing administrative 
procedures that govern the hours the system is in operation. If you 
have a fixed shutdown schedule, users can plan their work load and 
complete tasks in the allotted hours of timesharing. 

You can keep them informed by placing messages in the system 
NOTICE . TXT file. If the user selects to display it, the system prints 
the contents of NOTICE . TXT each time a user logs in. This is a 
convenient way to make sure all users know about important system 
operations . 



Chapter 5 
Managing Quotas 



This chapter describes the quotas 
resources. You can assign quotas 
account. RSTS/E quotas fall into 

o Disk quotas 

o Job quotas 

o Send/Receive quotas 

The remainder of this chapter describes these quotas in detail. See 
Chapter 7 for information on assigning or changing an account's 
quotas . 



that limit the use of various system 
to a user when you create an 
three categories: 



Disk Quotas 

You can limit the amount of space available to individual users on 
public or private disks by creating and maintaining quotas on those 
disks. Quotas are maintained and enforced on a per-disk basis, except 
for the public structure where it is maintained across the structure. 

You identify PPNs and assign quotas to them. The system automatically 
maintains usage counts during normal file activities . 

Each account that exists on a Level 1.2 disk, except for the [0,1] 
account, has a disk quota attribute block associated with it. The 
quota blocks have the following information: 

o Usage Actual number of blocks on the disk taken up by your 
files 

o Quotas -- Maximum number of blocks on the disk that your 
files can take up before the system issues an error message 
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Note 

For level 1.2 disks, RSTS/E uses 24 bits to store the 
disk quotas. Thus, quotas can be as large as the 
size of the largest disk supported by RSTS/E. 



Disk Quota Operations 

For pre-V9.0 disk structures, RSTS/E could only enforce disk quota 
limits at the time a user logged out. Thus, as a system manager, you 
could limit the amount of permanent disk space a user could have, but 
you could not limit the amount of temporary disk space. 

Now RSTS/E maintains, on level 1.2 disks only, two types of disk 
related quotas: a logged-in quota and a logged-out quota. If at least 
one user is logged in to the file's account, the system automatically 
checks the usage count against the logged-in quota as users create, 
delete, and extend files. If no one is logged in to the file's 
account, then RSTS/E checks the usage count against the logged-out 
quota. The system also enforces the logged-out quota when a user logs 
out . 

If extending the file causes the total disk usage to exceed the quota, 
RSTS/E rejects the operation and returns a ?Quota exceeded error 
message. When checking for a possible quota violation, RSTS/E takes 
into consideration the total write request. So, a write request that 
extends a file by multiple disk blocks is never only partially 
completed. 

To perform the quota checks, the monitor keeps a record of the number 
of blocks that it allocates to each account on each disk. For public 
disks, this record is kept on a per disk basis, but, when quota checks 
are made, the counts are added up across the public structure. The 
monitor keeps the usage information in memory and writes it back to 
the disk when appropriate. If the system crashes (leaving old 
information on a disk), the disk rebuild operation (CLEAN) recomputes 
the usage and writes the correct data on the disk. 



Logged-in Disk Quotas 

Logged-in disk quotas are the number of disk blocks that the system 
lets a user allocate while logged in. The number of blocks in use is 
the total number of blocks allocated. The allocation of any file is 
its actual size in blocks, rounded up to the nearest full cluster. 
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The allowable values are to 16,777,214 (2*24-2), and UNLIMITED. 
Zero means that no disk storage is allowed. UNLIMITED is a special 
value that means the monitor does not enforce the logged-in quota. 

Logged- in quotas do not apply on: 

o Level or Level 1.1 disk structures 

o Disks mounted using MOUNT/NOQUOTA (although the usage is 
still kept up to date) 

o Disks mounted using MOUNT/NOWRITE (because no file extends 
can take place on such a disk) 



Logged-Out Disk Quotas 

Logged-out disk quotas are the number of disk blocks that the system 
lets a user retain at log-out time. The logged-out quota is also 
checked when a user tries to create or extend a file in a logged-out 
account. 

The allocation of any file is its actual size in blocks, rounded up to 
the nearest full cluster. The number of blocks in use by any user is 
the total number of blocks allocated for all of the user's files. 

The allowable values are to 16,777,214 (2*24-2), or UNLIMITED. Zero 
means that no disk storage is allowed to remain allocated at logout 
time. UNLIMITED is a special value that means the monitor does not 
enforce the logged-out quota. 

When a job logs out, the monitor checks the logged-out disk quota of 
each disk against the usage of that disk. For the public structure, 
the system disk quota is checked against the total usage on the public 
structure. If the quota is exceeded (and no other interactive jobs 
are logged in under the same account) then the monitor rejects the 
logout request. 

Note 

For level and level 1.1 disk structures, the 
logged-out quotas remain the same as pre-V9.0. The 
allowable values are to 65,535, where zero means 
UNLIMITED. 
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Job Quotas 

For pre-V9.0 disk structures, there was no restriction on the number 
of attached jobs that a user was allowed to run. Thus, a user who had 
access to several terminals could gain control of a large number of 
job slots. In V9 . , each account has a job quota. 

The job quota specifies the total number of jobs (attached or 
detached) that each account can have active at any time. If the user 
attempts to exceed this quota, the system rejects the request and 
returns the ?Quota exceeded error message. If the user attempts to 
log in when the quota is reached, the system rejects the log-in 
request (see the section "Job Quotas and Login"). 

The default job quota is UNLIMITED. 



Detached-Job Quota 

For pre-V9.0 disk structures, you could establish a system-wide quota 
to control the number of jobs allowed to run detached under 
nonprivileged accounts. This limit was set up as the ratio of 
detached to attached jobs, which resulted in some problems when 
server-type jobs are required to run detached under accounts that may 
not have any attached jobs at all. 

In V9 . , the detached job quota is an account attribute. It indicates 
the actual number of jobs that are allowed to run detached under each 
account. If detaching a job causes this quota to be exceeded, then 
the system rejects the request and displays the following message: 

?Quota exceeded 

The quota check applies even if the user issuing the request is 
running under some other account. The detached job quota does not 
affect the automatic detaching operation that takes place when carrier 
is lost on a dial-up line controlling a job. In that case the job is 
unconditionally detached, but the quota is enforced when the user 
attempts to log back on (see the section "Job Quotas and Login"). 

For compatibility with pre-V9.0 disk structures, the detached job 
quota defaults to zero when you create an account. 
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Job Quotas and Login 

When a user attempts to log in, the system checks the current list of 
jobs under the account being logged in to against the quotas for that 
account. If either the detached job quota is exceeded or the job 
quota would be exceeded, the system rejects the log- in request. The 
system returns the list of currently detached jobs in the usual 
manner. 

If a user attempts to log in to some account and the job quota has 
been reached, the result depends on whether there currently are jobs 
running detached under that account. If there are none, the system 
rejects in the log-in request. If there are detached jobs, the system 
lets the user attach to one of them. 

If a user attempts to log in to some account and the detached job 
quota for that account has been exceeded, the system rejects the 
request but the user can attach to one of the detached jobs. Thus, 
the monitor ensures that one user cannot create an unlimited number of 
detached jobs. 



Send/Receive Quotas 

You can also limit the number of receiver ID blocks (RIBs) and the 
number of messages that a job can have at any time. 



RIB Quota 

Specifies the maximum number of RIBs that a job running under an 
account can set up for itself as a message receiver. The allowable 
range is to 256 or UNLIMITED. UNLIMITED is a special keyword that 
means no RIB quota is to be enforced. 



Message Quota 

Specifies the maximum total message quota that a job running under an 
account can request when declaring itself as a receiver. This maximum 
total must be shared by however many RIBs (local and network) the job 
wants to set up. The allowable range is to 65,535 or UNLIMITED. 
UNLIMITED is a special keyword that means no message quota is to be 
enforced . 
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This chapter describes the privileges that you can assign to a user 
when creating an account. Privileges restrict the performance of 
certain system activities to certain users. These restrictions 
protect the integrity of the operating system's performance and thus 
the integrity of service provided to users. You should grant 
privileges to each user on the basis of two factors: 

o Whether the user has a legitimate need for the privilege 

o Whether the user has the skill and experience to use the 
privilege without disrupting the system 

There are two types of privileges: RSTS/E - defined and user -defined . 



RSTS/E-Def ined Privileges 

RSTS/E -defined privileges fall into several categories. The 
categories are based on the level of impact the user has on the 
system: 






User - ■ 


■ Minimum privileges to use the system effectively 


o 


Group ■ 


■- Potential to affect users inside the same group 





World ■ 


■- Potential to affect users outside the same group 


o 


System 


-- Potential to affect normal system operation 





File 


• Potential to read or write file data 





All -- 


Potential to control the system 



Users can use the DCL command SET JOB/PRIVILEGE to enable and disable 
privileges for which they are authorized. Table 6-1 lists the 
privileges by category and gives a brief definition. 
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The sections that follow Table 6-1 describe each privilege in 
alphabetical order. For a function-by- function description of 
privilege requirements, see the RSTS/E Programming Manual, the RSTS/E 
System Directives Manual, or the RSTS/E System User's Guide. 



Table 6-1: RSTS/E Privileges 



Category 


■ + ■ 

| Privilege 


■ + 

| Activity Permitted 


User 


+ 

none 


- + 

Most normal activity except those listed 
j below 




SETPAS 


Change own password 


Group 


| GACNT 


| Management of all accounts in group 




| GREAD 


| Read access to all files in group 




| GWRITE 


| Write access to all files in group 


World 


| EXQTA 


| Exceed quotas 




i RDMEM 


| Read physical memory 




| WACNT 


| Management of all accounts 




| WREAD 


| Read access to all files 




j WWRITE 


| Write access to all files 


Files 


! DATES 


| Change file last access date 




| DEVICE 


| Access restricted devices 




GREAD 


j Read access to all files in group 




| GWRITE 


| Write access to all files in group 




| INSTAL 


j Add/remove/list system files, run-time 
| systems, libraries 




| WREAD 


j Read access to all files 




| WWRITE 


| Write access to all files 
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Table 6-1: RSTS/E Privileges (Cont.) 

+ + + + 

| Category | Privilege | Activity Permitted | 









System 


j DATES 


j Change system clock 




| HWCTL 
| JOBCTL 
| SWCTL 


| Perform system hardware control functions 
| Perform job control functions 
j Control logins and networking 




| HWCFG 
| SWCFG 


Set device characteristics 
| Set system parameters 




j INSTAL 


| Add/remove/list CCL commands 




| MOUNT 


| Mount and dismount devices 




| PBSCTL 


| Control Print/Batch services 




| SEND 


j Send to a restricted receiver, BROADCAST 
| messages 




1 SHUTUP 


| Shut down the system 




1 TUNE 


1 al for nri nfi l*u run hn rcit and 'iwsnni no 
mode 


All 


| RDNFS 


| Perform read-only non- file - structured I/O 




| SYSIO 


| Write files in [0,*] (with WWRITE) 




SYSMOD 


| Modify the system 




| WRTNFS 


| Perform read/write non - file - structured I/O 



DATES Privilege 

The DATES privilege lets you change the system date or time. You also 
need this privilege to change a file's date of last access or 
modification. 



DEVICE Privilege 

The DEVICE privilege lets you allocate, read, or write data on a 
restricted device. 
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EXQTA Privilege 

The exceed quota privilege (EXQTA) lets the space taken by the user's 
files on a given volume exceed any quota set for the user (as 
determined by the PPN) on that volume. However, this privilege does 
not let users exceed their logged-out quota when logging off the 
system. 

This privilege also lets users specify a priority ,' page limit, CPU 
limit, or time limit value with a PRINT or SUBMIT command that exceeds 
the maximum value for the specified queue. 

The primary use of EXQTA is by privileged programs that need to 
perform certain operations regardless of user quotas. Normally, you 
would not assign EXQTA to users. Instead, you should set the user's 
quotas to get the effect you want. 



GACNT Privilege 

The group accounting privilege (GACNT) lets a user perform account 
management functions, such as create/delete account and change 
passwords/quotas for all accounts with the same project number (group) 
as the user. GACNT also lets a user create batch jobs in any account 
in the user's group. 



GREAD Privilege 

The group read privilege (GREAD) allows the user's job read and 
execute access to any file whose project number is the same as the 
user's. 



G WRITE Privilege 

The group write privilege (GWRITE) gives the user's job create, 
rename, and write access to all files that have the same project 
number as the user's. 



HWCFG Privilege 

The hardware configuration privilege (HWCFG) lets you set terminal 
characteristics for any terminal, declare a device as restricted, and 
set line printer parameters. 
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HWCTL Privilege 

The hardware control privilege (HWCTL) lets you perform system control 
functions, for example setting terminal characteristics, seizing 
control of a device, or hanging up a modem line. 



INSTAL Privilege 

The install privilege (INSTAL) lets you add, remove, or list system 
files. You can also add or remove run-time systems, resident 
libraries, system logical names, or system commands (CCLs). 



JOBCTL Privilege 

The job control privilege (JOBCTL) lets you read the status of any 
other job, kill a job, or remove the receiver ID block (RIB) of 
another job. You can also create a job even if logins are disabled. 



MOUNT Privilege 

The MOUNT Privilege lets you mount shared disks, or use certain 
restricted MOUNT command qualifiers. 



PBSCTL Privilege 

The PBSCTL privilege lets you control the Print/Batch Services. For 
example, you can start or stop servers, or change printer forms. 



RDMEM Privilege 

The RDMEM privilege lets you read memory (PEEK) and perform read-only 
mapping of physical memory by executing the .PLAS system directive. 



RDNFS Privilege 

The RDNFS privilege lets the user's job perform read-only 
non- file - structured I/O operations. 
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Note 

This privilege lets a job access data anywhere on the 
selected disk without the benefit of any file 
structure. Grant it only to users who need it. If 
this privilege is given to unqualified users who do 
not need it, the operating system and service to 
other users can be disrupted. Such disruptions can 
include the exposure of confidential information to 
unauthorized persons. 



SEND Privilege 

The SEND privilege lets you send a message to a restricted receiver. 
You also need this privilege to BROADCAST a message to a terminal. 



SETPAS Privilege 

The SETPAS privilege lets users change their own password. This 
privilege enables the SET PASSWORD command. 



SHUTUP privilege 

The SHUTUP privilege lets you run the SHUTUP program to shut down the 
system. 



SWCFG Privilege 

The SWCFG privilege lets you perform system configuration functions 
such as: 

o Setting magnetic tape label defaults 
o Setting date/time presentation formats 
o Initializing queues and servers 
o Managing DECnet 
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SWCTL Privilege 

The software control privilege (SWCTL) lets you enable or disable 
logins. You also need this privilege to perform operational network 
management functions (for example, turning the network or individual 
circuits ON and OFF). 



SYSIO Privilege 

The SYSIO privilege lets the user's job: 

o Create, modify, rename, or delete files in [0,*] 

o Issue commands that write into files in [0,*] such as the 
DUMP/SYSTEM command 

o Declare a network receiver that accepts inbound network 
connection requests (a network server program) 

o Declare a receiver with a name that does not end with your 
job number 

o Set the privilege bit in the protection code of a file 



SYSMOD Privilege 

The SYSMOD privilege lets you perform functions that could modify the 
system: 

o Write memory with POKE 

o Map physical memory read/write 

o Map the I/O page 

o Perform non- file - structured reads and writes of a mounted 
disk 
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Note 

This privilege lets a job access data anywhere on the 
selected disk without the benefit of any file 
structure. Grant it only to users who need it. If 
this privilege is given to unqualified users who do 
not need it, the operating system and service to 
other users can be disrupted. Such disruptions can 
include the destruction of information on the system 
device, the destruction of user data, and the 
exposure of confidential information to unauthorized 
persons . 



TUNE Privilege 

The TUNE privilege lets you: 

o Enable or disable disk caching 

o Enable or disable file caching 

o Lock your job in memory 

o Set the maximum size any job can occupy in physical memory 
(SWAP MAX) 

o Set the maximum time any job can run when compute bound (run 
burst ) 

o Set the priority of any job 

o Change a batch server's priority and run burst 

You can increase or decrease the priority of a job by executing the 
UU.PRI system directive or the DCL command SET JOB/PRIORITY. With the 
same privilege, a job can spawn another job with a priority other than 
its own. You can create such a job by using an optional argument to 
the system directive UU.JOB. 

The TUNE privilege also lets you control whether a job can be swapped 
out of memory by executing the .SET system directive with the JFLOCK 
bit set. 

Because of their significant effect on system performance, the BACKUP 
and RESTORE commands also require TUNE privilege. 
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Note 

Do not grant the TUNE privilege widely; if 
unqualified users have unrestricted ability to set 
job priorities, the fair and orderly scheduling of 
jobs for execution can be disrupted. 

Grant the TUNE privilege only to users who need to 
lock a job in memory for performance reasons. 
(Typically, this will be a real-time application.) If 
unqualified users have the unrestricted ability to 
lock jobs in memory, physical memory may be held 
unnecessarily, thus degrading system performance. 



WACNT Privilege 

The world accounting privilege (WACNT) lets you perform account 
management functions, such as create/delete account and change 
password/quotas, for all accounts. Also, to spawn jobs or run batch 
jobs in any account on the system. 

To affect or to examine other accounts inside its own project number, 
a job needs only the GACNT privilege. But to affect or examine 
accounts outside its own project number, a job needs the WACNT 
privilege . 



WREAD Privilege 

The world read privilege (WREAD) gives you read and execute access to 
any file. 



WRTNFS Privilege 

The WRTNFS privilege lets you perform read/write non- file - structured 
I/O operations. 

Note 

This privilege lets a job access data anywhere on the 
selected disk without the benefit of any file 
structure. Grant it only to users who need it. If 
this privilege is given to unqualified users who do 
not need it, the operating system and service to 
other users can be disrupted. Such disruptions can 
include the destruction of information on the system 
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device, the destruction of user data, and the 
exposure of confidential information to unauthorized 
persons. 



WWRITE Privilege 

The world write privilege (WWRITE) gives you create, rename, and write 
access to all files except those in [0,*]. For files in [0,*], you 
need to have SYSIO privilege as well as WWRITE privilege. 



User-Defined Privileges 

The user-defined privileges (USERl-8) are eight privileges that have 
been reserved for your own definition. Third-party and user software 
can test them at the system program level to control various aspects 
of their application programs, such as restricted functions or 
restricted access to certain files. RSTS/E does not use these 
privileges for any access or privilege checks. 



Multiple Privileges and Jobs 

The following sections describe how the monitor handles privilege 
information during the life of a job. They describe: 



o 


Privilege Masks 


o 


Job Creation 


o 


Login 


o 


Logout 


o 


Spawned Jobs 



Privilege Masks 

A user's privileges are recorded in the job structure of the user's 
job in three privilege masks: authorized, current, and saved. When a 
user logs in to the system, the user's authorized and current 
privilege masks are initialized from the job's account attributes. 
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The saved privilege mask is a copy of the current privilege mask upon 
entry to a privileged program. When temporary privileges are dropped, 
the current privilege mask is restored from the saved privilege mask. 



Job creation 

At job creation, the monitor initializes both the current mask and the 
authorized mask, giving them all privileges except SYSMOD. 



Login 

When a job logs in, the system looks up the authorized mask in the 
account attributes. It copies this mask into the saved and authorized 
masks, ORs it into the current mask, and sets the job status to 
indicate the job has temporary privileges in effect. 

If a program logs in, it now has all the privileges it originally had 
plus possibly some new ones. When the program exits, the user has all 
authorized privileges enabled; temporary privileges are dropped. 

A user who logs in may not want all authorized privileges to be active 
at login. In that case the user can use a L0GIN.COM file to initially 
drop some privileges. 



Logout 

When a job logs out, the monitor clears the group- related privileges 
GACNT, GREAD, and GWRITE in all three privilege masks. This is done 
because the job is currently running with a project-programmer number 
(PPN) of [0,0] effectively putting it in group zero. The monitor 
drops group privileges because the intent of these privileges is to 
allow access to the user's group, not group zero. 

Apart from losing group privileges, a job neither gains nor loses any 
privileges as a result of logging out. 



Spawned jobs 

You can spawn a job using the UU.JOB system directive (see the RSTS/E 
System Directives Manual). A spawned job can be either logged- in or 
logged-out. For jobs spawned logged-in, the monitor usually gives the 
spawned job the set of authorized privileges for the account it logs 
in to. This is done before the program, if any, is run. If the 
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program is a privileged program, the usual additional privilege 
processing takes place (see the section "Running a Privileged 
Program" ) . 

Jobs spawned logged-out are given the privileges of the job executing 
the UU.JOB directive. 

Both logged-out and logged-in jobs spawned to an account other than 
the caller's require accounting privilege ( GACNT/WACNT ) . Spawning 
therefore lets users with accounting privilege create jobs that have 
some other account's privileges, possibly more than their own. 



Running Programs Under Multiple Privileges 

The following sections explain how the monitor handles privileges when 
running programs. They describe: 

o Running System Programs 

o Temporary Privileges 

o Designating a Program as Privileged 

o Running a Privileged Program 

o Program Exit 



Running System Programs 

System programs provide tools for performing common tasks, such as 
managing files and developing programs. Some programs are available 
to all users and require no particular privileges to run. They have a 
protection code <104>. EDT is an example of a nonprivileged system 
program. 

Other system programs perform functions for privileged users. Most 
privileged system programs have a protection code <104>, unless world 
file access is required to successfully execute the program. In that 
case the protection code is <124>. The difference between the 
nonprivileged program and the privileged program that have the same 
protection code is that the latter verifies that a user has the 
required privileges before proceeding. 

Some privileged system programs like SHUTUP have a protection code 
<232> but require the user to have a particular privilege to gain 
access. In the case of SHUTUP, the user needs the SHUTUP privilege to 
run the program. 
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Access to privileged system programs depends on the user's set of 
privileges. When a user attempts to run a privileged program, the 
program first performs a privilege check to determine if the user is 
sufficiently privileged. If the user has the correct set of 
privileges, the program grants access. See the individual description 
of each system program to determine what privileges are required to 
gain access. 



Temporary Privileges 

A program that performs privileged functions for a nonprivileged user 
receives the special designation of privileged program. When run, it 
gives the user temporary privileges, that is, all privileges except 
SYSMOD. When the program exits, the monitor withdraws the extra 
privileges from the user. Temporary privileges give the user access 
to privileged programs without compromising system security. 

Sometimes programs need to perform privileged functions for 
nonprivileged users. For example, SHUTUP needs to PEEK at memory, an 
activity that requires RDMEM privilege. Because it is a program, 
SHUTUP can PEEK in a controlled manner. Therefore, it is not a 
security risk. On the other hand, unrestricted use of the RDMEM 
privilege by a user can compromise system security. 



Designating a Program as Privileged 

A user designates an executable program as privileged by setting the 
privilege bit (128) and the executable bit (64) in the protection 
code. Therefore, any program with a protection code of <192> or 
higher is privileged. The normal protection code associated with 
privileged executable programs is <232>, granting execute access to 
all, but restricting read/write access to the owner. 

For security purposes, there are two restrictions regarding privileged 
programs : 

o A user needs the SYSIO privilege to be able to designate a 
program as privileged. 

o A privileged program cannot reside on a disk that is mounted 
/NOSHARE. This restriction prevents an outsider from 
acquiring privileges by bringing in a privileged program on a 
private pack. To be able to mount a disk /SHARE, a user 
needs the MOUNT privilege. Thus, it is important that users 
who have the ability to mount disks /SHARE know the contents 
of the disk they are mounting. 
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Running a Privileged Program 

When a user runs a privileged program, the monitor copies the 
account's current privilege mask into the saved privilege mask, then 
it ORs all privileges except SYSMOD into the current privilege mask, 
giving the user temporary privileges (all but SYSMOD). 

It is good programming practice to have privileged programs drop 
privileges on entry, and raise them only when needed. This practice 
provides better protection against programming errors damaging the 
system. It thereby improves system security. 



Program exit 

Whenever a program exits or chains to another program, the monitor 
performs the following privilege - related cleanup: 

o If temporary privileges are in effect, the monitor copies the 
saved mask back into the current mask. This cancels the 
temporary privileges. 

o The monitor cancels any third-party privilege check currently 
in effect (see the RSTS/E Programming Manual, SYS call 31, or 
the RSTS/E System Directives Manual, general directive 
UU. 3PP) . 

o If the job is currently logged out and does not have WACNT 
privilege, and the program exits, then the monitor kills the 
job. Passing control from one program to another program is 
possible without restriction when a job is logged out, but 
other operations that exit the current program result in a 
self -kill. 

o If the program being exited is a privileged program, then the 
monitor clears the job's memory and sets the job size to the 
minimum size for the job's default keyboard monitor. 
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This chapter gives background information on managing RSTS/E accounts, 
and then describes the DCL commands you use to create and maintain 
accounts. Table 7-1 summarizes these commands. 



Table 7-1: DCL Commands for Managing Accounts 

+ + + 

| Command | Description | 



CREATE/ACCOUNT | 


Sets up 


a new account on a file 


-structured disk 


DELETE/ACCOUNT | 


Deletes 


an account 


from a file- 


structured disk 


SET ACCOUNT | 


Changes 


an account' 


s attributes 




SET PASSWORD | 


Changes 


an account' 


s password 




SHOW ACCOUNT 


Displays 


account at 


tributes 





Accounts 

An account is the structure by which RSTS/E recognizes a timesharing 
user, and in which RSTS/E maintains usage and access data. Each 
account is identified by a PPN, and can exist on any disk public, 
or private. However, you can only log in to accounts that are defined 
on the booted system disk. 
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The public disk structure can be one or more disks and collectively 
these disk(s) are represented by the logical name, SY: . Within the 
public structure, the booted disk is known as SYO:. You can 
explicitly create, delete, or modify accounts on SYO: or any private 
disk, but not on other public disks. The system automatically extends 
accounts on public disks as needed. The only command that lets you 
specify a public disk in the device specification is SHOW ACCOUNT. 

RSTS/E has two types of accounts: 

o User -- Contains files and login attributes 

o Nonuser -- Only contains files 

The system decides which type account to create by the following 
rules: 

o Explicitly by qualifier: /USER or /NOUSER 

o Implicitly by the presence of any qualifier that suggests a 
user account such as /IN_QUOTA, /PRIVILEGES, /[NO]LOOKUP, or 
/[NO] NETWORK 

o Neither of the above: /USER is assumed if the disk is SYO:, 
/NOUSER is assumed if the disk is private 



Project-Programmer Number (PPN) 

RSTS/E identifies each account by a pro ject -programmer number (PPN). 
You can specify the project or programmer number as a single value or 
a range of values. You assign the PPN when you create the account. 
The PPN cannot be changed. Valid PPNs are: [0,1-254] and 
[1-254,0-254] . 

Note that [0,1-254] are legal PPNs for nonuser accounts only; they are 
not legal PPNs for user accounts. That is, no job can log in under 
[0,*]. Account [0,1] is created when the disk is initialized, and 
cannot be deleted. Also, [0,1-199] are reserved for DIGITAL software 
and [0,200-254] are reserved for user software packages. 
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Account Access Privileges 

There are three categories of access to account information. A 
different set of privilege flags control each category. The 
categories are: 

o Read information - - Read accounting data and account 
attributes 

None You can read and display accounting information 
in the current account (except the password blockette) 

GACNT You can read and display accounting information 
of any account in your group 

WACNT -- You can read and display accounting information 
of any account 

o Set information -- Write accounting data and attributes to, 
or create or delete accounts 

GACNT -- You can write accounting data of any account in 
your group 

WACNT -- You can write accounting data of any account on 
the system 



o Set password -- Write (change) the passwords 

SETPAS -- You can change your own password (using the SET 
PASSWORD command, only) 

GACNT - - You can change the password of any account in 
your group 

WACNT - - You can change the password of any account on 
the system 



The privileges are inclusive: that is, if you have sufficient 
privilege to perform a given operation on any account in your group, 
you can also perform that operation on your own account. Similarly, 
if you have sufficient privilege to perform a given operation on any 
account on the system, you can perform that operation on any account 
in your group (including your own account). 
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Account Data 

The following sections describe the data an account has to manage 
timesharing access and usage. Unless the section notes otherwise, 
each account element is: 

o Initialized by CREATE/ACCOUNT 

o Changed by SET ACCOUNT 

o Displayed by SHOW ACCOUNT 

o Deleted by DELETE/ACCOUNT 



Account Name 

The account name can be 1 to 14 characters, chosen from the ASCII 
character set whose decimal values are 9, 32 through 126, and 161 
through 254. This field is displayed by the SHOW ACCOUNT command, by 
PBS on job and file header pages, and by the BROADCAST command on 
message headers. 



Date/Time/Keyboard of Last Login 

The date and time that the account was most recently logged in to, and 
the keyboard at which that login occurred. The monitor maintains 
these data. You cannot change these fields with account management 
commands or monitor directives. 



Date/Time of Last Password Change 

The date and time that the account's password was most recently 
changed. The monitor maintains these data. You cannot change these 
fields with account management commands or monitor directives. 



Password 

Normally, the system stores an account's password on the disk in such 
a way that it cannot be looked up. You select this form of storage 
with the /NOLOOKUP qualifier. If you need compatibility with earlier 
versions of RSTS/E, the /LOOKUP qualifier directs the system to store 
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an account's password on the disk in such a way that the UU.RAD 
directive can be used to look it up (see the RSTS/E System Directives 
Manual). No DIGITAL - supplied program displays passwords. 

For a /NOLOOKUP account, the password can be 6 to 14 characters long, 
chosen from the ASCII character set whose decimal values are 9, 32 to 
62, 64 to 126, and 161 to 254. For a /LOOKUP account, the password 
must consist of six alphanumeric characters. 

A user can change an account's password using the SET PASSWORD command 
if the user has SETPAS privilege. 

An account can also be set to the special state /NOPASSWORD_PROMPT . 
When this is so, LOGIN permits access to the account without requiring 
(or prompting for) a password. The password still exists; however, it 
is not used until the special state is cleared by setting 
/PASSWORD PROMPT. 



Interactive Flag 

If set, the interactive flag lets a user log in under an account. If 
the interactive flag is not set, the system does not allow a job to be 
logged in under this account's PPN, except by the create job directive 
UU.CRE (see the RSTS/E System Directives Manual). No logins (by use 
of the UU.LIN system directive), interactive or otherwise, are 
allowed . 

Note 

Batch jobs are still allowed even if the interactive 
flag is not set. 



Captive Account Flag 

The captive account flag controls the way in which a job under a given 
account exits. If the captive flag is set, the system expects the job 
to remain totally under the control of a predetermined procedure, such 
as a login command procedure or a menu processor. Any attempt to exit 
to the keyboard monitor signals either an error or some devious 
action. The monitor converts such an exit request into a self-kill 
directive and removes the job. 
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Network Flag 

The network flag, if set, lets you initiate a job under a given 
account over a network connection. This flag allows or disallows any 
network activity, for example, a remote COPY or SET HOST. 



Dial-Up Flag 

The dial-up flag, if set, lets you initiate a job under a given 
account over dial-up lines. 



Expiration Date 

The expiration date specified by this field is the last date on which 
you can initiate a job under the associated account. The system can 
be instructed (/EXPIRE without a date argument) never to allow 
initiation of a job under the PPN of this account. 

You can disable this field using /NOEXPIRE. The /NOEXPIRE qualifier 
lets an account remain usable indefinitely. 



Authorized Privilege Mask 

The authorized privilege mask specifies the maximum set of privileges 
that a job running under this account can exercise (other than by 
running privileged programs). 

When a job logs in, all authorized privileges for the account are 
copied to the job's current privilege mask. You can use commands in 
your L0GIN.COM file to turn off some privileges at log in. 



Creation Date 

The date that the account was created. You assign the creation date 
when you create the account. The creation date cannot be changed. 



UFD Cluster Size 

UFD cluster size is the number of 512-byte blocks that each cluster 
allocated to the account's directory contains. You assign the UFD 
cluster size of a directory when you create an account. The UFD 
cluster size cannot be changed. 
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An account can have a maximum of seven clusters; therefore, the UFD 

clustersize affects the maximum number of files that can be stored in 

the account. This maximum value is further affected by the size of 
each file, its cluster size and attributes. 



Quotas 

You can assign quotas on disk usage, job slots, and message receiver 
slots when you create an account. See Chapter 5 for a discussion of 
these quotas. 



System Data 

The system account [0,1] on the system disk, is used to support 
certain system parameters such as the system password. 



Commands 

The following sections describe the commands which you can use to 
manage accounts. All parameters can be specified on the command line. 
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CREATE/ACCOUNT Command 

The CREATE/ACCOUNT command sets up a new account on a file - structured 
disk. CREATE/ACCOUNT requires GACNT or WACNT privileges. 



Format 

CREATE/ACCOUNT dev : [ p , pn ] 
Command Qualifiers 
/[NO] CAPTIVE 

/CLUSTER_SIZE=ufd- cluster - size 

/DETACHED__JOB_QUOTA=det ached - j ob - quota 

/[NO]DIALUP 

/[NO]EXPIRE=date-spec 

/IN_QUOTA=logged- in-quota 

/[NO] INTERACTIVE 

/JOB_QUOTA= j ob - quota 

/[NO] LOG 

/[NO] LOOKUP 

/MESSAGE_QUOTA=message -quota 
/NAME="account name" 
/[NO] NETWORK 

/OUT_QUOTA=logged - out - quota 
/[ NO] PAS SWORD JPROMPT 
/POSITION=posi tion 
/PRIVILEGES=(priv / . . . ) 
/RIB_QUOTA=rib- quota 
/SIZE=ufd- size 
/TEMPLATE=dev : [ p , pn ] 
/[NO]USER 

Prompts 

Account : 



Defaults 

/NOCAPTIVE 

/DETACHED_JOB__QUOTA=0 

/DIALUP 

/NOEXPIRE 

/IN_QUOTA=UNLIMITED 
See discussion 
/JOB_QUOTA=UNLIMITED 
/LOG 

/NOLOOKUP 

/ME S S AGE__QUOTA= 1 2 

/NETWORK 

/OUT__QUOTA=UNLIMITED 

/PAS SWORD__PROMPT 

/POSITION=INDEX 

/PRIVILEGES=SETPAS 

/RIB_QUOTA=3 

/SIZE=1 

See discussion 



Command Parameters 



dev : [ p, pn ] 



Device specification of a mounted device and the PPN for the 
account to create. You must specify either the device 
specification or PPN. The default value for dev: is _SY0:. The 
default PPN is your PPN. You can have wildcards and ranges in 
the PPN specification. The allowable values for the PPN depend 
on the privileges you have. 
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Command Qualifiers 
/[NO] CAPTIVE 

Indicates whether the account is to be a captive account. 

The default is /NOCAPTIVE. 

/CLUSTER_SIZE=ufd- cluster- size 

The number of 512-byte blocks that each cluster in this account's 
UFD contains. Acceptable values are 1, 2, 4, 8, or 16. The 
value cannot be less than the pack cluster size of the specified 
disk . 

/DETACHED_JOB_QUOTA=de tached -job- quota 
See Chapter 5. The default is 0. 
/[NO]DIALUP 

Indicates whether logins from dial-up terminal lines are allowed. 

The default is /DIALUP. 

/[NO]EXPIRE=date- spec 

/NOEXPIRE means that the account is never to expire. 

/EXPIRE=date - spec means that the account expires at the end of 
the date you specify. 

/EXPIRE without a date specification means that the account is to 
be marked as "already expired," that is, unavailable for any job 
to run or be created under its PPN. 

The default is /NOEXPIRE. 

/IN_QUOTA=logged- in-quota 

See Chapter 5. The allowable values are to 16,777,214 and 
UNLIMITED. Zero means that no disk storage is allowed. 
UNLIMITED is a special value that means the monitor does not 
enforce the logged-in quota. The default is UNLIMITED. 
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/[NO] INTERACTIVE 

This qualifier controls the way in which you can create a job 
under this account. If you set /NOINTERACTIVE , the system does 
not allow jobs to be logged in under this account's PPN except by 
the create job directive UU.CRE (see the RSTS/E System Directives 
Manual ) . 

The default is /INTERACTIVE. 
/JOB_QUOTA= job- quota 

See Chapter 5. The default is UNLIMITED. 
/[NO] LOG 

If /LOG is in effect, the CREATE function logs the creation of 
the new user or nonuser account with one of the following 
messages : 

User account dev:[p,pn] created at <device cluster number> 
Non-user account dev:[p,pn] created at <device cluster number> 

The default is /LOG. 

/[NO] LOOKUP 

/NOLOOKUP means that RSTS/E stores the password in such a way 
that it cannot be looked up. /LOOKUP means that RSTS/E stores 
the password in a manner that follows the RSTS/E V8 . G rules. 

The default is /NOLOOKUP. 

/MESSAGE__QUOTA=mess age -guota 

See Chapter 5. The allowable values can be from to 65,535 or 
UNLIMITED. The UNLIMITED keyword means that the monitor does not 
enforce the message quota. 

The default is 12. 

/NAME=" account name" 

Can be 1 to 13 characters, chosen from the ASCII character set 
whose decimal values are 9, 32 to 126, and 161 to 254. 

/[NO] NETWORK 

Indicates whether logins over network connections are allowed. 
The default is /NETWORK. 
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/OUT_QUOTA= logged - out - quota 

See Chapter 5. The allowable values are to 16,777,214 and 
UNLIMITED. Zero means that no disk storage is allowed to remain 
at logout time. UNLIMITED is a special value that means the 
monitor does not enforce the logged-out quota. 

The default is UNLIMITED. 

/ [ NO ] PAS SWORD_PROMPT 

/NOPASSWORD_PROMPT means that LOGIN is not to require or prompt 
for a password for a user to gain access to the specified account 
(that is, specifying the [p,pn] in response to User: is 
sufficient to log a user in to the account). 

The default is /PASSWORD_PROMPT . 

/POSITION=posi tion 

The starting position of the account's UFD expressed in device 
cluster numbers (DCNs). Legal values are 1 through the maximum 
DCN for the specified disk. 

MIDDLE is a special value that means create the UFD for this 
account as near as possible to the middle of the disk. INDEX is 
a special value that means create the UFD as near as possible to 
the master file index. 

The default is INDEX. 

/PRIVILEGE=(priv, . . . ) 

The possible values for each priv are: NONE, ALL, a privilege 
keyword, or a privilege keyword with a NO prefix. ALL means all 
privileges that the current user has enabled. 

RSTS/E scans the list from left to right, with each successive 
term adding or taking away privileges. For example, 
( ALL , NOWWRI TE ) means all privileges except WWRITE . 

If you specify /TEMPLATE=dev: [ p,pn] , RSTS/E treats the template 
account's privileges as though they appeared to the left of all 
the entries in the /PRIVILEGE qualifier. 

/RIB_QUOTA=rib-guota 

See Chapter 5. The allowable values can be from to 256 or 
UNLIMITED. The UNLIMITED keyword means that the monitor does not 
enforce the RIB quota. 

The default is 3. 
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/SIZE=uf d - si ze 

The initial size of the new account's UFD expressed in clusters. 
Acceptable values are - 7. 

The default is 1. 

/TEMPLATE=dev : [ p , pn ] 

If present, this qualifier indicates that the specified account's 
parameters are to be used as defaults for the new account's 
parameters. You must specify either the device specification or 
the PPN. 

The default value for dev: is _SY0 : . The default PPN is your 
PPN. 

Note 

The specified account's password, size, and 
position are not part of the defaults for the new 
account . 

/[NO]USER 

Indicates the type of account to create. /USER means create an 
account with login attributes and file storage capabilities. 
/NOUSER means create an account for file storage only. 

The default is /NOUSER. 
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DELETE/ACCOUNT Command 

The DELETE/ACCOUNT command removes an account from a file - structured 
disk. DELETE/ACCOUNT requires WACNT or GACNT privilege and WWRITE or 
GWRITE privilege. You also need SYSIO privilege to delete a [0,*] 
account . 



Format 

DELETE/ACCOUNT dev : [ p , pn ] 
Command Qualifiers 
/[NO]LOG 

/[ NO ] PURGE [ =QUERY ] 

/[NO] QUERY 

/ [ NO ] RESET [ =QUERY ] 

/[NO]USER 

Prompts 

Account : 



Defaults 
/LOG 

See discussion 
See discussion 
See discussion 
See discussion 



Command Parameters 
dev : [ p , pn ] 

Device specification of a mounted disk, and the PPN of the 
account to delete from the specified disk. You can omit the 
device specification (the default is _SY0 : ) ; you must specify the 
PPN. The PPN field allows wildcards and ranges. 

Unless you specify /NOQUERY, the system requests confirmation 
that you really want to delete the account: 

Really delete account dev:[p,pn] <NO> ? 

Command Qualifiers 

/[NO] LOG 

If /LOG is in effect, the DELETE function logs the deletion of 
the account: 

Account dev:[p,pn] deleted 

The default is /LOG. 
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/[ NO ] PURGE [ =QUERY ] 

This qualifier controls the actions to be taken if the account 
contains files. When you specify /PURGE, DELETE/ACCOUNT deletes 
any files which it finds, and then deletes the account. If you 
specify the optional argument (=QUERY), RSTS/E displays a warning 
message that files exist for the specified account and requests 
permission to proceed. 

When you specify /NOPURGE, DELETE/ACCOUNT displays a warning 
message if files exist in the account, skips the account, and 
goes to the next account if a wildcard account was specified: 

%Account dev:[p,pn] has n blocks of disk allocated 
Account dev:[p,pn] not deleted 

If you do not specify /PURGE, /NOPURGE, or if /PURGE=QUERY is 
specified, DELETE/ACCOUNT proceeds if no files exist. Otherwise, 
before proceeding, RSTS/E displays a prompt indicating that there 
are files in the account: 

Proceed ( Y/N ) <N> ? 

Deleting files (either by /PURGE or by answering YES to the 
prompt) requires GWRITE or WWRITE privilege. If any file deleted 
by DELETE/ACCOUNT has protected data (protection code = 128), the 
system writes over the file with zeros before deletion. 

/[NO] QUERY 

Controls the action taken if the account has nonzero accounting 
data or contains files. 

/QUERY indicates that RSTS/E displays a prompt before deleting 
any account. /NOQUERY indicates that RSTS/E only displays a 
message if the account has nonzero accounting data or contains 
files. 

The default is /NOQUERY. 

/[ NO ] RESET [ =QUERY ] 

Controls the action taken if the specified account has nonzero 
accounting data (CPU time, device time, connect time, or 
kilo-core- ticks) . If you specify /RESET, RSTS/E deletes the 
account even if it has nonzero accounting data. If you specify 
the optional argument (=QUERY), RSTS/E displays a warning message 
that the specified account has nonzero accounting data and asks 
for permission to proceed. 
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If you specify /NORESET, DELETE/ACCOUNT displays a warning 
message if the account has nonzero accounting data, skips the 
account, and goes to the next account if a wildcard account was 
specified: 

%Account dev:[p,pn] has nonzero accounting statistics 
Account dev:[p,pn] not deleted 

If you do not specify /RESET, /NORESET, or if /RESET=QUERY is 
specified, the delete account operation proceeds if the 
accounting data is zero. Otherwise, RSTS/E displays a warning 
message indicating that the specified account has nonzero data 
and asks for permission to proceed. 

/[NO]USER 

You can restrict the search for a given account to a specific 
type (user or nonuser) by using this qualifier. The default is 
to search all accounts. 

Examples 

o To always delete an account regardless of its current state, 
type : 

DELETE/ACCOUNT/PURGE/RE SET/NOQUERY 



o To never delete an account that has files or nonzero 
accounting data, type: 

DELETE/ACCOUNT/NOPURGE/NORESET 



o To always be prompted before deleting an account, type: 
DELETE/ACCOUNT/QUERY 



o To only be prompted for an account that has files or nonzero 
accounting data, type: 

DELETE/ACCOUNT 
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SET ACCOUNT Command 

The SET ACCOUNT command modifies account parameters on a 

file - structured disk. SET ACCOUNT requires GACNT or WACNT privilege. 



Format 

SET ACCOUNT dev:[p,pn] 

Command Qualifiers Defaults 

/[NO] CAPTIVE 

/DETACHED_JOB_QUOTA=det ached - j ob - quota 
/[NO]DIALUP 

/[ NO] EXPIRE [ =date- spec] 
/IN_QUOTA=logged - in-quota 
/[NO] INTERACTIVE 
/JOB_QUOTA= j ob - quota 

/[NO] LOG /LOG 
/[NO] LOOKUP 

/MESSAGE_QUOTA=message -quota 
/NAME= 11 account name" 
/[NO] NETWORK 

/OUT_QUOTA=logged - out - quota 
/[ NO ] PASSWORD_PROMPT 
/PRIVILEGES=(priv / . . . ) 
i /RIB_QUOTA=rib-quota 

| /[NO]USER 

i 
i 

j Prompts 

i 

j Account: 

+ + 

Command Parameters 
dev. [p,pn] 

Device specification of a mounted disk and the PPN of the account 
to modify on the specified disk. You can omit either the device 
specification or the PPN, but not both. The default device 
specification is _SY0 : . The default PPN is the user's PPN. 

You can have wildcards and ranges in the PPN specification. 
RSTS/E uses all qualifiers that apply to a specific account and 
displays the following informational message: 



Account dev:[ppn] modified 



SET ACCOUNT 



If no qualifiers apply to a selected account, the system displays 
the following warning message: 

%Account dev:[ppn] not modified 

Command Qualifiers 

/[NO]CAPTIVE 

Indicates whether the account is to be a captive account. 
/DETACHED_JOB_QUOTA=de tached -job- quota 

See Chapter 5. 
/[NO]DIALUP 

Indicates whether logins from dial-up terminal lines are allowed. 

/[NO]EXPIRE=date- spec 

/NOEXPIRE means that the account is never to expire. 

/EXPIRE=date - spec means that the account is to expire at the end 
of the day specified. 

/EXPIRE without a date specification means that the account is to 
be marked as unconditionally expired, that is, unavailable for 
any job to run under its PPN. 

/IN_QUOTA=logged- in-quota 

See Chapter 5. 

/[NO] INTERACTIVE 

This qualifier controls the way in which you can create a job 
under this account. If you set /NOINTERACTIVE , the system does 
not allow jobs to be logged in under this account's PPN except by 
the create job directive UU.CRE (see RSTS/E System Directives 
Manual ) . 

/JOB_QUOTA= job- quota 

See Chapter 5. 
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/[NO] LOG 

If /LOG is in effect, the SET ACCOUNT function logs the 
modification of the account: 

Account dev:[p,pn] modified 

If /NOLOG is in effect, only warning messages are logged. 

The default is /LOG. 

/[NO] LOOKUP 

/NOLOOKUP means that RSTS/E stores the password in such a way 
that it cannot be looked up. /LOOKUP means that RSTS/E stores 
the password in a manner that follows the pre-V9.0 rules. 

/MESSAGE_QUOTA=message - quota 

See Chapter 5. 

/NAME=" account name" 

Can be 1 to 13 characters, chosen from the ASCII character set 
whose decimal values are 9, 32 to 126, and 161 to 254. 

/[NO] NETWORK 

Indicates whether logins over network connections are allowed. 

/OUT_QUOTA=logged - out -quota 

See Chapter 5. 

/ [ NO ] PAS SWORD_PROMPT 

If you specify /NOPASSWORD__PROMPT , the account is set to not 
require a password for logging in. To resume password prompting, 
specify /PASSWORD_PROMPT ; the password is the same as it was 
before /NOPASSWORD__PROMPT was specified. 
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/PRIVILEGE=(priv / . . . ) 

This qualifier modifies the privileges currently assigned to the 
account. A priv specification occurring in the positive form 
adds the associated privilege to the account's authorized 
privilege mask; a NOpriv specification removes the associated 
privilege. Note that the change affects only future logins; jobs 
already logged in are unaffected. 

A positive specification (priv) is effective only if you are 
authorized to have that privilege. However, any user with WACNT 
or GACNT (as appropriate) can remove any privilege. 

/RIB_QUOTA=rib-guota 

See Chapter 5. 

/[NO]USER 

You can restrict the search for a given account to a specific 
type (user or nonuser) with this qualifier. 

The default is to search all accounts. 
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SET PASSWORD Command 

The SET PASSWORD command lets you change the password of the specified 
user account. When you issue this command, the system responds with: 

New password: 

You then enter the desired new password. If the entry is invalid or a 
null string (RETURN only), the system gives the error message ?Invalid 
password, and returns to the New password prompt. The system accepts 
an oversize password string; however, it ignores the excess characters 
and displays a warning message. 

After you enter a new password, the system prompts: 

New password again, for verification: 

You then reenter the same password. If the passwords do not match, 
the system displays the error message ?Verif ication mismatch, does not 
change the password, and returns to command level. If the passwords 
match, the system displays the /LOG message, if any, and returns to 
command level. 

Users need SETPAS (or either GACNT or WACNT) privilege to change their 
own password. Users need GACNT or WACNT privilege to change another 
account's password. If you only have SETPAS, the system prompts you 
for the old password: 

Old password: 

You must enter the correct current password for your account. A 
mismatch results in the error message ?Old password validation error. 

+ + 

| Format | 

| SET PASSWORD [dev:[p,pn]] | 

| Command Qualifiers Defaults | 

I /[NO] LOG /LOG | 

I /SYSTEM | 

| Prompts | 

j See description | 
+ + 
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Command Parameters 



dev: [ p,pn] 

Device specification of a mounted disk, and the PPN of the 
account for which to change the password. You can omit the 
device specification, the PPN, or both. The default device 
specification is _SY0 : . The default PPN is the user's PPN. 



If a nonuser account is specified, the system displays a warning 
message : 

% [ppn] is not a user account 

You can have wildcards and ranges in the PPN specification. If a 
wildcard or range specification includes a nonuser account, 
RSTS/E skips the account and does not display a message. 

Note 

Users who only have SETPAS privilege cannot 
specify a devrppn parameter; in that case, RSTS/E 
rejects the command and displays the following 
error message: 

?Need xACNT privilege to access dev: [ppn] 

Command Qualifiers 

/[NO]LOG 

If /LOG is set, successful setting of a new password yields: 

Password set for account dev:[p,pn] 
The default is /LOG. 



/SYSTEM 

If you specify /SYSTEM , the new password replaces the old system 
password. You must have WACNT privilege to change the system 
password . 
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SHOW ACCOUNT Command 

The SHOW ACCOUNT command displays account attributes. No privilege is 
required to display your own account. You need GACNT or WACNT 
privilege to display other accounts. 



Format 

SHOW ACCOUNT dev:[p,pn] 

Command Qualifiers 

/AC COUNT I NG_DATA 

/ALL 

/BRIEF 

/FULL 

/OUTPUT=f ilespec 
/[ NO ] RESET 
/[NOJUSER 

Prompts 

None 



Defaults 

See discussion 
See discussion 
/BRIEF 



/NORESET 

See discussion 



Command Parameters 
dev : [ p , pn ] 

Device specification of a mounted disk, and a PPN. 
be a wildcard or range specification (for appropriately 

privileged users). You c" --^ 

and the PPN. The default 
default PPN is the user' 



can omit 
device 
s PPN. 



The PPN can 

ely 

both the device specification 
specification is _SY0 : . The 



Command Qualifiers 

/AC COUNT I NG_DATA 

Produces a one-line display of accounting data for the specified 
accounts. This qualifier conflicts with /BRIEF and /FULL. If 
you specify them in combination, the rightmost qualifier 
overrides the others and execution proceeds without an error. 



/ALL 



Produces a display of all accounts on the specified disk. If a 
account is specified along with /ALL, the account specification 
overrides /ALL. 
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/BRIEF 

Produces a display that uses only one line per account. You 
cannot use /BRIEF in combination with /RESET. When shown the 
display, the letters IDNCLP indicate that the account has the 
following attributes: 



I = 


Inte ractive 


D = 


Dial -up 


N = 


Network 


C = 


Captive 


L = 


Lookup password 


P = 


Password prompt 



/FULL 

Produces a complete display for the accounts specified. 
/OUTPUT=f ilespec 

If specified, the display is written to the file you specify. 
/[NO]USER 

Specifies which accounts are to be included in the display. 
/USER means only display accounts with login attributes. /NOUSER 
means only display accounts without login attributes. 

The default is to display all accounts. 

/[ NO ] RESET 

Indicates whether the accounting data is reset after being 
displayed. /RESET requires GACNT or WACNT privilege. You cannot 
use /RESET in combination with /BRIEF. If neither 
/ACCOUNTING_DATA or /FULL is specified, /ACCOUNT I NG_DATA is 
assumed . 

The default is /NORESET. 
Examples 

The following are samples of the output from the SHOW ACCOUNT command 
with different qualifiers. 
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§ SHOW ACCOUNT/BRIEF [*,194] 



Account 

[1,194] 
[2,194] 
[3,194] 
[4,194] 
[10,194] 



Name 

Blade Runner 
JT Sysgen 
JT PIP 
JT ACTMGR 



Allocation IDNCLP Last Login 



6016 
5080 
4336 
3280 
752 



IDN 
I 

IDN 
IDN 



P KB2 6: 
P KB32: 
P KB32: 
P 



03 -Dec-84 
12-Nov-84 
06-Nov-84 



01 
02 
03 



24 
56 
06 



Expi res 

PM 15-AUG-88 

PM 

PM 



5 accounts matching _SY0:[*,194] 
Total allocation: 19464 



Note 



If an asterisk (*) character appears after the value 
in the allocation field, it means the account is over 
quota . 



$ SHOW ACCOUNT/ACCOUNTING_DATA [*,194] 
Account Name Allocation 



[1,194] 
[2,194] 
[3,194] 
[4,194] 
[10,194] 



Blade Runner 
JT Sysgen 
JT PIP 
JT ACTMGR 



6016 
5080 
4336 
3280 
752 



5 accounts matching _SY0:[*,194] 
Total allocation: 19464 



KCT 

52377442 
2215 
859 
797 



Note 



CPU- time Connect Device 



58:23:24.9 
00:00:17.5 
00:00:08.6 
00:00.09.7 



903:25 
00:15 
00:17 
00:02 



214:35 
00:00 
00:00 
00:00 



If an asterisk (*) character appears after the value 
in the allocation field, it means the account is over 
quota . 



§ SHOW ACCOUNT/FULL 

_SY0: [1,214] "Blade Runner" 



Created 09-May-85 



Privileges: GACNT WACNT GREAD GWRITE WREAD WWRITE DATES DEVICE EXQTA 

HWCFG HWCTL INSTAL JOBCTL MOUNT PBSCTL RDMEM USER0 USERl 

USER2 USER3 USER4 USER5 USER6 USER7 RDNFS SEND SETPAS 

SHUTUP SWCFG SWCTL SYS IO SYSMOD TUNE WRTNFS 



Attributes : 



INTERACTIVE 
NOLOOKUP 



DIALUP NETWORK 
PASSWORD PROMPT 



NOCAPTIVE 
EXPIRES: 15-Aug-88 



Quotas : 



Disk usage 
Job limits 
Send/Receive 



Logged out: 
Detached : 
RIB: 



unlimited 
unlimited 
256 



Logged in: 
Total: 
Message : 



Accounting: 



CPU Time: 
Device Time: 
Connect Time: 



58:23:24 .9 
214:35 
903:25 



Kilo - Core - Ti ck s : 
UFD Clustersize: 
Blocks allocated: 



unlimi ted 
3 

unlimited 

52377442 
16 
6000 



Last Password Change on 28-Nov-84 at 03:21 PM 
Last login on _KB26: on 03-Dec-84 at 01:24 PM 

Note 



If an * appears after the value in any field in the 
quotas section, it means the account is over quota. 
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Chapter 8 
Managing Terminals 



This chapter gives background information on managing terminals. The 
RSTS/E operating system supports a variety of terminals. During the 
generation of your system, you specify the number and types of 
terminal interfaces that are to be part of your hardware 
configuration. While you do specify terminal interfaces, you do not 
assign specific terminal characteristics at that time. The RSTS/E 
operating system automatically sets the default characteristics of all 
interfaces to certain standard values: 

o Produces hard-copy output 

o Prints data up to 80 columns wide 

o Receives data at a baud rate of 9600 

o Sets autobaud detection on multiplexed lines 

You must use the SET TERMINAL command to set the characteristics of 
the terminals that do not have these standard default values. 



Understanding the SET TERMINAL Command 

The SET TERMINAL command sets characteristics for terminals attached 
locally to a RSTS/E system or for terminals connected by dial-up 
lines. Users can use the SET TERMINAL command to set characteristics 
for their own terminals. Only users with HWCFG privilege can use the 
SET TERMINAL command to define characteristics for other terminals. 

The /AUTOBAUD qualifier lets the system detect and set the baud rate 
of any multiplexed terminal when the user logs in. As system manager, 
you can include SET TERMINAL/NOAUTO/PERM commands in the START.COM 
file for all multiplexed terminals you want to manually set the baud 
rate. 
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There are two methods for setting the characteristics of dial-up 
lines : 

o Nonpr ivileged user sets characteristics. All dial-up lines 
start out with the standard default settings. Consequently, 
the user of a dial-up line must log in to the system at the 
standard default settings, and then use the SET TERMINAL 
command to set the characteristics of the terminal. Note 
that the terminal characteristics revert to the standard 
settings when the user logs out. 

o A user with HWCFG privilege sets permanent characteristics. 
You can issue the SET TERMINAL/AUTOBAUD/PERMANENT command to 
set the permanent characteristics. This causes the system to 
automatically use the characteristics you set, instead of the 
standard values, each time a user logs in on a particular 
dial-up line. Note that the permanent characteristics remain 
in effect for the current time-sharing session, unless you 
issue a new SET TERMINAL command. 



Terminal Line Speed Characteristics File: TERSPD.SYS 

You need to create a special terminal line speed characteristics file 
if you have these two circumstances: 

o You decide to restrict the valid line speeds at certain 
terminals to a subset of the line speeds allowed by the 
terminal interface. 

o You install an interface that has been modified so 

nonstandard line speeds are substituted for one or more 
standard interface line speeds. 

The following guidelines can help you prepare a terminal line speed 
characteristics file: 

1. Gather the information on the restrictions or modifications 
and the keyboard numbers of the terminals affected 

2. Create a file named TERSPD.SYS with a text editor 

3. Include all of the information from step 1 in the file 

4. Place the file in the system library account. 
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Note 

The /AUTOBAUD qualifier does not honor the restricted 
speeds in TERSPD.SYS. 

You can use the file TERSPD.SYS to allow only certain speeds on 
certain terminals. The format for each line of the file is the 
terminal device designator, a colon, and a list of speeds to allow for 
that terminal; each speed separated by a comma. For example: 

KBF2: 300,1200,... 

The terminal device designator can be KBnn: , TTnn : , or KBcnn:. The 
old form (KBnn: or TTnn:) produces the same result as in pre-V9.0 
RSTS/E. In the new form (KBcnn:), c indicates the hardware controller 
and nn is a subline on that type controller. Table 8-1 lists 
controller types that RSTS/E supports. 

DIGITAL recommends that you use the new form to specify terminal 
devices in the START.COM, TERSPD.SYS, and TERDFL . SYS files. In this 
way, if you change the number of pseudo keyboards, you do not have to 
change those files. The SHOW DEVICE command displays both forms of 
the device designator for each keyboard. 



Table 8-1: RSTS/E Supported Controller Types 



Code 


■ + 

1 


Controller Type 


A 


■ + 


DLll A, B type single line interface 


B 




DLll C,D type single line interface 


C 




DL11E type single line modem interface 


D 




Pseudo keyboards 


E 




DJ multiplexor 


F 




DH multiplexor 


G 




DZ/DZV/DZQ multiplexor 


H 




DHV/DHU multiplexor 



You can specify up to 16 speeds for each terminal. You can specify a 
range of terminals on one line as low-end terminal device designator, 
an optional colon, dash, high-end terminal device designator, 
mandatory colon, and then the list of speeds. 
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For example: 

KBG0-KBH8: 300,1200,... 

When you specify a terminal number without any speeds after it, no 
speeds are allowed and the speed cannot be changed. You can use blank 
lines, comment lines (lines beginning with an exclamation mark), and 
comments at the end of lines to document the file. 

An example of a TERSPD.SYS file follows: 



TERSPD . SYS 

This file is used by the system manager to define 
those speeds which are allowed on each terminal. 
The format is as follows: 
KBn:list of speeds separated by commas. 

KBFO: INo speeds allowed for KBFO 

KBF1 : 2400 , 9600 IKBFl can have either 2400 or 9600 

KBF2 : -KBF4 :9600 IKBF2 to KBF4 can have 9600 only 

KBF5:9600,EXTA,EXTB ! KBF5 can use 9600 & external speeds 

KBF6: 0,50, 7 5, 11 0,1 50, 200, 300,6 00,12 00,18 00,24 00,4800,9600 

KBF7 : 0,50, 7 5, 11 0,1 50, 2 00, 300, 600, 1200, 18 00, 2 4 00, 48 00, 9600, EXTA,EXTB 

KBF8-KBF1 5: 0,50, 7 5, 11 0,150, 200, 30 0,600, 1200, 1800, 24 00, 9600 

KBG0-KBH8: 50, 300,1200,2 4 00, 48 00,96 00 

KBH9: 0,50, 7 5, 11 0,1 50, 200, 300 ,60 0,1 200, 1800, 24 00, 9600 

KBH10 : -KBH15 : 300 , 600 , 1200 IKBH10 to KBH15 are dial-up lines 



Note 

The DLllE-type interface and the individual local 
interfaces (KLll and DL11A through DL11D) and the 
DJll multiplexer do not have programmable baud rates. 
For this reason, you cannot execute commands to 
change baud rates on a keyboard line having any of 
those interfaces (KBAnn, KBBnn, KBCnn, and KBEnn) . 



Setting Terminals Other Than Your Own 

If you have HWCFG privilege, you can set the characteristics of other 
terminals in the RSTS/E system with the SET TERMINAL command. For 
example, if you want to set the characteristics of a VT100 terminal 
at KB32, type: 

$ SET TERMINAL/VT1 KB32: 
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After you type the keyboard number and press the RETURN key, RSTS/E 
immediately sets the characteristics of the line to those of a VT100 
alphanumeric display terminal. DCL prints the dollar sign ($) prompt 
again to let you enter another command. 

You can also change specific characteristics of a terminal. For 
example, to limit the line length of the terminal at KB40, type: 

$ SET TERMINAL/WIDTH=6 KB40: 
$ 

Each time 60 characters print on KB40, the system performs a carriage 
return and line feed. 

Use the /PERMANENT qualifier to specify characteristics on a 
logged-out terminal. For example, you can use /PERMANENT to set an 
initial WIDTH characteristic for a pseudo keyboard: 

$ SET TERMINAL/WIDTH=70/PERMANENT KBDO : 



User-Defined Terminal Characteristics File: TERMAC • SYS 

Each line of TERMAC. SYS contains the unique name for a terminal type 
and the command qualifiers that define the characteristics of that 
terminal type. The qualifiers are explained in the description of the 
SET TERMINAL command at the end of this chapter. 

The /TYPE=n qualifier assigns a unique 8-bit binary value to each 
terminal type. The values to 128. are reserved for use by DIGITAL. 
The values 129. to 255. are available for user-defined terminal types. 
The SHOW TERMINAL command uses this value to locate a terminal's 
characteristics . 

An example of a TERMAC. SYS file follows: 
j 

! TERMAC. SYS 

i 

VT125X/DEV=VT12 5/WIDTH=80/SPEED=( 300 , 9600 )/TYPE=201 
GIGI/DEV=VK100/SETUP=GREEN/TYPE=202 I VK100 W/GREEN BACKGROUND 
DIABLO/DEV=LA34/SPEED=9600/WID=8 0/SETUP=DIABLO/TYPE=2 3 
LA3 4X/DEV=LA3 4/TAB/SPEED=9 6 0/TYPE=2 4 
VT52X/DEV=VT52/SPEED=1200/TYPE=205 
FOO/DEV=BAR/WI DTH= 1 3 2/TYPE=2 6 

BAR/DEV=LA1 2 0/SETUP=NARROW/WIDTH=8 0/TYPE=2 7 

For example, to define an LA120 that has only 80-column paper, place 
the following line in the file: 

MYLA120/DEVICE=LA120/WIDTH=8 0/TYPE=208 
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Then, use the following command to set KB19: to these characteristics: 
$ SET TERMINAL/DEVI CE=MYLAl 2 O/PERMANENT KB19: 

You can initialize your terminals to the known terminal types and 
their default characteristics through the use of the TERMAC . SYS file. 
You can use blank lines, comment lines (lines beginning with an 
exclamation mark), and comments at the end of lines to document the 
file. 



Automatic Setting of Terminal Characteristics: TERDFL . SYS 

The file TERDFL. SYS establishes default terminal characteristics for 
nonstandard keyboards. The file is used whenever the user executes 
the SET TERMINAL/INQUIRE command and the system was unable to 
determine the terminal type. The system looks up the terminal number 
in the file and, if found, sets the characteristics that are on that 
line. If the terminal number is not found, the system displays an 
error message. 

For most DIGITAL terminals, SET TERMINAL/INQUIRE can determine the 
type. The only supported exception is the LA36. The same may apply 
to older, unsupported terminals or terminals made by other 
manufacturers. 

If you want the SET TERMINAL/INQUIRE command to work for terminals 
whose type cannot be determined, enter them in the TERDFL. SYS file. 
(It is not necessary to put any other supported terminals in the 
file.) If SET TERMINAL/INQUIRE can determine the type, it ignores any 
entry in TERDFL. SYS. 

An example of a TERDFL. SYS file follows: 
i 

! TERDFL. SYS 

i 

KBHl : - KBH1 5 : /DEV=LA3 6 

The format for each line of the file is the terminal device 
designator, a colon, and then the command qualifiers that define the 
characteristics of the keyboard. A range of terminals can be 
specified on one line as the low-end terminal device designator, an 
optional colon, a dash, the high-end terminal device designator, a 
mandatory colon, and then the qualifiers. 

You can use blank lines, comment lines (lines beginning with an 
exclamation mark), and comments at the end of lines to document the 
file. 
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Setting Permanent Terminal Characteristics 

The /PERMANENT qualifier lets you set the permanent characteristics of 
a terminal. For example, to set the characteristics of the dial-up 
line on keyboard 14 for the current time-sharing session, you log in 
to an account that has HWCFG privilege and type the command: 

$ SET TERMINAL/PERMANENT KB14 :/DEV=LA36 

When you include the /PERMANENT switch with the SET TERMINAL command, 
the command takes effect immediately. If you do not have HWCFG 
privilege or the characteristics of the line conflict with the 
command, RSTS/E prints an error message and reprints the DCL prompt. 
The characteristics set by executing a SET TERMINAL/PERMANENT command 
are in effect until the next system shut down or until you change 
them. If you set characteristics without /PERMANENT, they revert to 
the standard characteristics on logout. 

Use the /PERMANENT qualifier with all SET TERMINAL commands in 
START.COM. 



Using the /NOBROADCAST and /BROADCAST Command Qualifiers 

The /NOBROADCAST qualifier prevents your terminal or any terminal on 
the system from receiving broadcasts sent by the BROADCAST command. 
Use this when: 



o You need to print a document on a letter -quality printer and 
do not want messages corrupting the printout 

o You are using a text editor in screen mode at a dial-up 

terminal set at a low baud rate. Repainting the screen each 
time someone sends a message can be time consuming, 
especially at 300 baud. 

Use the /BROADCAST qualifier to allow your terminal to receive 
messages again. Use the /NOBROADCAST qualifier to keep messages from 
printing on your own terminal. For example: 



$ SET TERMINAL/NOBROADCAST 
$ SHOW TERMINAL/BRIEF 

Terminal: KB29: Device_Type: VT52 



Break 

CRFill=0 

No Hostsync 

Scope 

Width=80 

$ 



No Broadcast 
No Delimiter 
Interactive 
Speed=9600 



Control=(R,T,C 
No Eight_bit 
Lowercase 
Tab 



No Control=X 
No Form 

Resume=Control_C 
TTSync 
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The SHOW TERMINAL command lets you verify that the command worked a 
that the rest of the terminal settings are set properly. If you 
decide to reverse this condition, use the /BROADCAST qualifier. Fo 
example : 



$ SET TERMINAL/BROADCAST 
$ SHOW TERMINAL/BRIEF 



Terminal: KB29: 

Break 

CRFill=0 

No Hostsync 

Scope 

Width=80 

$ 



Device_Type: VT52 



Broadcast 
No Delimiter 
Interactive 
Speed=9600 



Control= ( R, T, C 
No Eight_bit 
Lowercase 
Tab 



No Control=X 
No Form 
Resume=Control 
TTSync 



Your terminal can now receive BROADCAST messages. 

You can also' use the /NOBROADCAST and /BROADCAST qualifiers on othe 
terminals on your system. Use the SET TERMINAL command as follows: 

$ SET TERMINAL KB25 : /NOBROADCAST/PERM 

$ SHOW TERMINAL/BRIEF KB25: 

Terminal: KB25: Device__Type : VT100 



Break 

CRFill=0 

Hostsync 

Scope 

Width=80 

$ 



No Broadcast 
No Delimiter 
Interactive 
Speed=9600 



Control= ( R, T, C ) 
No Eight__bit 
Lowercase 
Tab 



No Control=X 
No Form 
Resume=Control 
TTSync 



Error Messages 

See Appendix D for a summary of the DCL error messages. 
Commands 

The following sections explain the commands available for managing 
terminals: SET TERMINAL and SHOW TERMINAL. 
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SET TERMINAL Command 

The SET TERMINAL command sets characteristics for terminals attached 
locally to a RSTS/E system or for terminals connected by dial-up 
lines. Users can use the SET TERMINAL command to set characteristics 
for their own terminals. You need HWCFG privilege to define 
characteristics for other terminals. 



+ 



Format 



SET TERMINAL [KB[c]nn[:]] 

Command Qualifiers Defaults 

/[NO]132_COLUMNS None 

/ [ NO ] ADVANCED_VI DEO 

/ [ NO ] ALT_MODE 

/[NO]ANSI 

/ [ NO ] AUTOBAUD 

/[NO] BREAK 

/[NO] BROADCAST 

/BUFFER_QUOTA=n /BUFFER_QUOTA=l 8 

/[NO]CONTROL=[ (option[ option, ...])] 

/[NO]CRFILL[=n] 

/ [ NO ] DEL I MI TER [ =C ] 

/[DEVICE_TYPE=] terminal type 

/[NO]DIALUP 

/ [ NO ] E I GHT_B I T 

/[ NO ] ESCAPE_SEQUENCE 

/[NO] FORM_FEED 

/HARDCOPY 

/[NO]HOST_SYNC 

/INQUIRE 

/[NO] INTERACTIVE 

/ [ NO ] KATAKANA 

/ [ NO ] LOADABLE_CHARACTERS 

/[NO]LOCAL_ECHO 

/LOWERCASE [ =INPUT | OUTPUT ] 

/[NO ] PARITY [ =option ] 

/PERMANENT 

/[ NO ] PRINTER_PORT 

/[NO]REGIS 

/RESET See discussion 

/[NO ] RESTRICT 

/RESUME= [ ANY | CONTROL_C ] 

/SCOPE 

/SELECT_ERASE 
/SETUP=f ilename 
/[NO]SIXEL 

/SPEED= ( input [ , output ) ] 
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+ - + 

| Command Qualifiers (Cont.) Defaults (Cont.) | 

| /[NO] TAB | 

I /[ NO ] TTSYNC I 

| /TYPE=n | 

| /[NO]UP_ARROW | 

| /UPPERCASE [=INPUT | OUTPUT] | 

| /[ NO ] USER__DEFINED__KEYS | 

| /WIDTH=n I 

+ - + 

Command Parameters 

[KB[c]nn[ : ] ] 

Indicates the terminal to set the characteristics for. If you do 
not specify a terminal, RSTS/E sets the the characteristics of 
the terminal that issued the command. You must have HWCFG 
privilege to set the characteristics for another user's terminal. 

Command Qualifiers 

/[NO] 132_COLUMNS 

If you specify /132_COLUMNS , the terminal displays single-width 
characters in an array of 24 lines by 132 columns. If you 
specify /NOl 32_COLUMNS , the terminal displays single-width 
characters in an array of 24 lines by 80 columns. 

/ [ NO ] ADVANCED_VI DEO 

If you specify /ADVANCED__VIDEO , it means the terminal has the 
advanced video option (AVO). The advanced features include 
character attributes (blinking, bolding, and so on), screen 

memory, and ROM sockets. If you specify /NOADVANCED__VI DEO , it 
means the terminal does not support AVO. 

/ [ NO ] ALT__MODE 

If you specify /ALT__MODE, the system treats ASCII 027, 125, and 
126 as ESCAPE. If you specify /NOALT_MODE, the system treats 
only ASCII 027 code as ESCAPE. 

See /LOWERCASE for more information on the use of this qualifier. 
/[NO]ANSI 

If you specify /ANSI, it means the terminal supports ANSI escape 
sequences. If you specify /NOANSI, it means the terminal does 
not support ANSI escape sequences. 
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/ [ NO ] AUTOBAUD 

If you specify /AUTOBAUD, the system monitors the terminal line 
to detect and set baud rates without requiring the user to 
manually set or determine the terminal's speed. If you specify 
/NOAUTOBAUD, the system does not set the terminal line's speed 
without manual intervention. 

/[NO] BREAK 

If you specify /BREAK, the system translates the BREAK key as a 
CTRL/C character (ASCII 3). If you specify /NOBREAK, the system 
translates the BREAK key as a null character (ASCII 0). 

/[NO] BROADCAST 

The /BROADCAST qualifier enables the system broadcast capability 
for the terminal. That is, RSTS/E displays messages from the 
SEND system function call on the terminal. The /NOBROADCAST 
qualifier disables the system broadcast capability for the 
terminal . 

/BUFFER_QUOTA=n 

Indicates the number of input characters that you can buffer 
before the system issues an XOFF character to your terminal to 
stop transmission. The buffer quota value is a multiple of 30. 
The allowable values range from 180 to 7650. By default, the 
system uses a quota of 180 characters. 

The system uses one small buffer for each 30 characters. Thus, 
the default buffer quota of 180 characters uses a maximum of six 
small buffers for terminal input. Changing a terminal's input 
buffer quota is useful for high-speed input terminals. However, 
if there are not enough small buffers available, a terminal may 
not be able to reach its full quota. 

You need HWCFG privilege to use the /BUFFER_QUOTA qualifier. 

/[NO]CONTROL=[ ( option [ , opt ion, ...])] 

If you specify /CONTROL=C, the system traps a CTRL/C typed by the 
user and handles it accordingly. If you specify /NOCONTROL=C , 
the system ignores a CTRL/C typed by the user. 

If you specify /CONTROL=R, the system enables the CTRL/R retype 
facility. If you specify /NOCONTROL=R, the system disables the 
CTRL/R retype facility. 

If you specify /CONTROL=T, the system enables the CTRL/T job 
status display facility. If you specify /NOCONTROL=T, the system 
disables the CTRL/T job status display facility. 
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If you specify /CONTROL=X, the system traps a CTRL/X typed by the 
user and clears the user's entire type-ahead buffer. If you 
specify /NOCONTROL=X, the system interprets a CTRL/X typed by the 
user as data. 

If you want to set or reset more than one option on a single 
command line, you can combine them in a list. For example: 
/CONTROL= ( R , T , C ) or /NOCONTROL= ( C , X ) . 

/[NO]CRFILL[=n] 

If you specify /CRFILL , the system sets the carriage return fill 
factor to n, where n is between and 6. If the argument is not 
specified or is zero, or if /NOCRFILL is specified, the system 
does not generate any fill characters. 

/[ NO] DELIMITER [ =c ] 

If the argument is a character within quotation marks (for 
example /DELIMITER= "\" ) , the character within quotation marks 
becomes the private delimiter. 

If the argument is a number (for example /DELIMITER=9 ) , the 
private delimiter is the ASCII character whose decimal value is 
the number. This allows for any ASCII character whose decimal 
value is between 1 and 127 to be a private delimiter. 

If you specify /NODELIMITER, the system removes the private 
delimiter that was previously set. 

/[DEVICE_TYPE=] terminal type 

Sets the default characteristics for the terminal type specified 
or, if it is a name of a user-defined macro, sets the 
characteristics defined in the macro. 

This command recognizes the following terminal types: 



LAI 2 
LA3 4 
LA36 
LA38 



LA50 
LAI 
LAI 20 



VK100 

VT52 

VT55 



LA180S VT100 



VT101 
VT102 
VT105 
VT125 



VT131 
VT132 
VT220 
VT24 



See the section "Use r - Defined Terminal Characteristics: 
TERMAC . SYS " for a description and example of the user-defined 
macro file. 



/[NO]DIALUP 



Indicates if dial-up control is enabled for the specified 
te rminal . 
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/ [ NO ] E I GHT__B I T 

If you specify /EIGHT_BIT, it means the terminal supports eight 
bit characters. If you specify /NOEIGHT_BIT, it means the 
terminal does not support eight bit characters. 

/[ NO ] ESCAPE_SEQUENCE 

If you specify /ESCAPE__SEQUENCE , the system treats an ESC 
character (value 27) as an indication of an incoming escape 
sequence. The system does not echo the character and or any of 
the characters in the sequence. If you specify 

/NOESCAPE_SEQUENCE / the system treats an ESC character (value 27) 
as a line terminator and echoes it as a $ character. 

/[NO] FORM_FEED 

The /FORM_FEED qualifier indicates that the hardware has form 
feed and vertical tab capabilities. The system transmits form 
feed and vertical tab characters without translation. The 
/NOFORM_FEED qualifier indicates that the hardware does not have 
form feed and vertical tab capabilities. The system transmits 
four line feed characters in place of a form feed or vertical tab 
character. 

/HARDCOPY 

If you specify /HARDCOPY, it means the terminal is not a cathode 
ray terminal (CRT) display device. The system echoes a DEL 
character (RUBOUT) by printing a backslash (\) and the last 
character typed and removes the last character typed from the 
terminal input buffer. Later DEL characters cause the next to 
last characters to be sequentially printed and removed from the 
terminal input buffer until a character other than DEL is 
received. As a result, the system echoes another \ to delimit 
the erased characters and then echoes the correct character. 

If you specify /HARDCOPY and /[ NO ] TTSYNC is not specified, 
/NOTTSYNC is set by default. 

/[NOJHOSTSYNC 

Specify /HOSTSYNC if the terminal has special hardware that lets 
the computer interrupt transmission of characters from the 
terminal by sending the terminal an XOFF character (value 19). 
Similarly, the computer instructs the terminal to resume 
transmission of characters by sending the terminal an XON 
character (value 17). The terminal hardware must respond to XOFF 
and XON characters by stopping and resuming transmission. 

Specify /NOHOSTSYNC if the terminal does not have the hardware 
required for the HOSTSYNC feature. 
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/INQUIRE 

Queries the terminal by sending an ANSI ESCAPE identifying 
sequence, then determines the terminal type and sets the 
appropriate terminal characteristics. If the terminal does not 
respond within five seconds, the system searches the file 
TERDFL . SYS to see if there are default characteristics for this 
terminal. If an entry is found, the system sets the specified 
characteristics. If not, the system displays an error message 
and the terminal characteristics are unchanged. 

Note 

This qualifier causes the terminal's type-ahead 
buffer to be cleared. LA36 terminals do not 
support this feature. 

See the section "Automatic Setting of Terminal Characteristics: 
TERDFL. SYS" for more information on using /INQUIRE with terminals 
that do not respond to the identifying sequence. 

/[NO] INTERACTIVE 

Indicates that you can use the terminal to log in to the system. 
If you specify /NOINTERACTIVE , the system ignores any characters 
input from the terminal while it is not assigned to another job 
or not opened. Use this attribute for KB devices set up as 
printing devices. 

/ [ NO ] KATAKANA 

Indicates that the terminal supports the Katakana character set. 

/ [ NO ] LOADABLE_CHARACTERS 

Indicates that the terminal supports dynamically redefinable 
character sets (for example, changing fonts). 

/[NO]LOCAL_ECHO 

If you specify /LOCAL_ECHO, the system does not echo characters 
it receives from the terminal. This is only used for a terminal 
that does its own local echo. 

If you specify /NOLOCAL_ECHO, characters generated are sent only 
to the computer. Therefore, the system echoes each character it 
receives so the character is displayed locally and then 
translates certain characters to perform the proper action. For 
example, the system echoes a CR character as a carriage return 
and line feed sequence. 
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/LOWERCASE [ =INPUT | OUTPUT ] 

The /LOWERCASE=INPUT qualifier indicates that the system enables 
lowercase input from the terminal. The /LOWERCASE=OUTPUT 
qualifier indicates that the system enables lowercase output to 
the terminal. 

If you specify /LOWERCASE with no argument, the system enables 
lowercase input and output. If you specify /LOWERCASE or 
/LOWERCASE=INPUT and / [ NO ] ALTMODE is not specified, the system 
sets /NOALTMODE by default. 

/[ NO ] PARITY=EVEN | ODD 

If you specify /NOPARITY, the system ignores the parity bit on 
characters it receives and treats the parity bit on characters it 
transmits to the terminal as if the parity bit were a data bit. 

If you specify /PARITY=EVEN , the system sends characters to the 
terminal with the parity bit properly set for even parity but 
ignores the parity bit on characters it receives. 

If you specify /PARlTY=ODD, the system sends characters to the 
terminal with the parity bit properly set for odd parity but 
ignores the parity bit on characters it receives. 

/PERMANENT 

If you specify /PERMANENT, the other qualifiers on the same 
command line become the terminal's permanent characteristics. 
Permanent characteristics are the characteristics of the terminal 
when it is not in use. The characteristics of the terminal 
revert to the permanent characteristics when the user logs out. 

You must use /PERMANENT to specify the characteristics of any 
terminal, including dial-up controlled terminals. You must have 
HWCFG privilege to specify this qualifier. 

/[ NO ) PRINTER__PORT 

Indicates that the terminal has a printer port. 

/[NO]REGIS 

Indicates that the terminal supports the Remote Graphic 
Instruction Set (ReGIS). 

/RESET 

Resets the terminal's characteristics to the permanent 
characteristics . 



8-15 



SET TERMINAL 



/[ NO ] RESTRICT 

If you specify /RESTRICT, it means that only users with DEVICE 
privilege can access the specified terminal. If you specify 
/NORESTRICT, it means that any users can access the specified 
terminal . 

This qualifier only reflects OPENS and ASSIGNS of the device: 
not LOGINS. 

/RESUME= [ ANY | CONTROL_C ] 

Defines the XON/XOFF processing. The argument ANY enables type 
out and echo when any character is typed after XOFF. The 
argument CONTROL_C enables type out and echo only when you type 
XON or CTRL/C after XOFF. 

/SCOPE 

Specify /SCOPE if the terminal is a CRT display terminal that has 
the following characteristics: 

o Conforms to synchronization as described under the /TTSYNC 
command . 

o System echoes a DEL character (RUBOUT) as backspace, space, 
and backspace sequence. 

If you specify /SCOPE, and /[NO ] TTSYNC is not specified, /TTSYNC 
is set by default. 

/[ NO ] SELECT_ERASE 

Indicates if the terminal supports the selectively erasable 
character attribute. 

If the terminal supports this feature, the terminal recognizes 
two forms of the erase in line and erase in display commands. In 
one form all characters within the set parameter are erased 
regardless of logical attributes. The second form changes all 
characters designated with the selectively erasable character 
attribute into spaces. 

/SETUP=f ilespec 

Sends the specified file's data to the terminal, in binary mode. 
If you specify a file name only, the system assumes the file is 
in the user's account on the system disk with a file type of 
.ESC. The user must have access to the file or an error results. 
Use this command to initialize a terminal for which you can make 
special software settings. 
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/[NO] SIXEL 

Indicates if the terminal supports Sixel Graphics. Sixel 
Graphics transfer binary graphic images between the host and the 
terminal or the terminal and a printer. 

/SPEED= ( input [ , output ) ] 

Specifies the speed at which the terminal sends and receives 
data . 

You can specify the speed as a single value to set the input and 
output baud rates to the same speed. To specify a split speed 
for input and output, specify /SPEED= ( n, m) , where the values n 
and m indicate the input (terminal to host) and output (host to 
terminal) baud rates, respectively. 

Note 

The /SPEED qualifier works on DH, DHV, DHU, and 
DZ terminals. Split speed only works on DH, DHV, 
and DHU terminals. 

You can use the keywords EXTA and EXTB to specify a baud rate 
associated with the External Clock A and External Clock B baud 
rates, respectively. 

See the section "Terminal Line Speed Characteristics File: 
TERSPD.SYS" for a description and example of the speed file. 

/ [ NO ] TAB 

/TAB indicates the terminal hardware has tab capability. The 
system transmits TAB characters without translation. 

/NOTAB indicates the terminal hardware does not have tab 
capability. To move to the next tab stop, the system transmits 
the correct number of space characters instead of transmitting a 
TAB character. 

/[ NO ] TTSYNC 

If you specify /TTSYNC, the terminal obeys the following 
synchronization standard: if the terminal sends an XOFF character 
(equivalent to the CTRL/S combination), the computer interrupts 
transmission until the terminal sends either an XON character 
(equivalent to the CTRL/Q combination) or a CTRL/C combination. 

If you specify /NOTTSYNC, XON and XOFF characters sent by the 
terminal have no special meaning. 
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/TYPE=n 

Specifies the value of the terminal's type code. This type code 
coincides with a particular terminal type and the SHOW TERMINAL 
command uses it to display the terminal type. This qualifier is 
best used in the TERMAC . SYS file to associate a terminal with a 
user-defined macro. 

Allowable values are to 255. The values to 128. are reserved 
for DIGITAL use. 

/[NO ] UP__ARROW 

If you specify /UP_ARROW / the system echoes a control and graphic 
character combination as the A character (value 94) followed by 
the proper graphic character. For example, CTRL/E prints out as 
~E. 

If you specify /NOUP_ARROW / the system echoes the control and 
graphic character combination as is. 

/UPPERCASE [ =INPUT | OUTPUT ] 

The /UPPERCASE=INPUT qualifier indicates that the system disables 
lowercase input from the terminal. The /UPPERCASE=OUTPUT 
qualifier indicates that the system disables lowercase output to 
the terminal. 

If you specify /UPPERCASE with no argument, the system disables 
lowercase input and output. If you specify /UPPERCASE or 
/UPPERCASE=INPUT and / [ NO ] ALTMODE is not specified, the system 
sets /ALTMODE by default. 

/[ NO ] USER_DEFINED_KEYS 

Indicates if the terminal supports User Defined Keys (UDKs). 
User Defined Keys let you save a full command string and invoke 
it with a single key. 
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/WIDTH=n 

Sets the width of the print line for the terminal to n. The 
width can be between 1 and 254. As a result, the system 
automatically generates a carriage return/line feed combination 
if n printing characters have been printed or echoed without a 
carriage return/line feed combination and another printing 
character is to be transmitted. 

If the terminal executing the program is in the VT100/200 family 
and the print line width is changed, then the appropriate ESC 
sequences are sent to the terminal to change the width of the 
screen accordingly. For example, if the width changes from 80 or 
less to 81 or more, then the width of the screen is set to 132; 
if the width changes from 81 or more to 80 or less, the width of 
the screen is set to 80. 
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SHOW TERMINAL Command 

Displays the current characteristics of a specific terminal. You can 
change each of these characteristics with a corresponding option of 
the SET TERMINAL command. 



+ 



Format 



- - + 



SHOW TERMINAL [KB[c]nn[:]] 

Command Qualifiers 

/ALL 

/BRIEF 

/FULL 

/[NO] PERMANENT 



Defaults 

Current Terminal 

/BRIEF 

/BRIEF 

/NOPERMANENT 



+ 



+ 



Command Parameters 
[KB[c]nn[ : ] ] 

Indicates the terminal for which to show the characteristics. 
When you do not specify a terminal, the system displays the 
characteristics of the terminal executing the command. You must 
have HWCFG privilege to specify another user's terminal. 

Command Qualifiers 



/ALL 



Displays the characteristics of all the terminals configured on 
the system. If a terminal is specified along with /ALL, the 
terminal specification overrides /ALL. 

/BRIEF 

If you specify /BRIEF, or neither /BRIEF nor /FULL, then a subset 
of the full display is shown. 

/FULL 

If you specify /FULL, the full display is shown. 
/[NO] PERMANENT 

If you specify /PERMANENT, the system displays the permanent 
characteristics of the terminal. If you specify /NOPERMANENT, 
the system displays the current characteristics of the terminal. 
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Examples 

The following examples show the output format for the SHOW TERMINAL 
command : 



$ SHOW TERMINAL/BRIEF 
Terminal: KB26: 

No Break 

CRFill=0 

Hostsync 

Scope 

Width=80 



Device_Type: VT220 

Broadcast 
No Delimiter 
Interactive 
Speed=9600 



Control=(R,T,C) 
Eight_bit 
Lowercase 
Tab 



No Control=X 
No Form 

Resume=Control_C 
TTSync 



$ SHOW TERMINAL/FULL 
Terminal: KB26: 

132_Columns 

No Autobaud 

Control=(R,T,C) 

No Dialup 

Hostsync 

No Local_Echo 

No ReGis 

Select_Erase 

TTSync 



Device_Type: VT220 

Advanced_Video 

No Break 

No Control=X 

Eight_bit 

Interactive 

Lowercase 

Restricted 

No Sixel 

Up_Arrow 



No Alt Mode 



ANSI 



Broadcast Buf f er_Quota=180 

CRFill=0 no Delimiter 

No Escape_Sequence no Form 

No Katakana Loadable_Characters 

No Parity Printer_Port 

Resume=Control_C Scope 

Speed=9600 Tab 

User_Def ined_Keys width=80 



8-21 



Chapter 9 
Managing Print/Batch Services 



This chapter gives background information on the Print/Batch Services 
(PBS) package. PBS contains routines to help you manage your RSTS/E 
V9 . print and batch servers. 

The chapter then describes the DCL commands for using PBS. Table 9-1 
summarizes the DCL commands. 



Table 9-1: DCL Commands for the Print/Batch Services Package 

+ + + 

i Command | Description | 

+ + + 

i Package-Related | 

+ + + 

I START/QUEUE/MANAGER | Starts the Print/Batch Services package | 

I I I 

| STOP/QUEUE/MANAGER | Shuts down the Print/Batch Services package | 

+ + + 

| Entry-Related | 

+ + + 

| DELETE/ENTRY | Deletes one or more print or batch entries | 

| | selected by entry-spec or entry-number | 

I I I 

| PRINT | Queues a request for printing one or more | 

I | files | 

I I I 

| SET ENTRY | Modifies the attributes of one or more print | 

| | or batch entries I 

I I I 

| SHOW ENTRY | Displays the attributes and status of one or | 

I | more print or batch entries I 

I I I 

| SUBMIT j Queues a request for batch processing one or | 

I I more command files I 



9-1 



Managing Print/Batch Services 



Table 9-1: DCL Commands for the Print/Batch Services Package (Cont.) 



Command 


1 


Description 






Queue-Related 



ASSIGN/QUEUE 
CLOSE/QUEUE 

DEAS SIGN/QUEUE 

DELETE/QUEUE 

INITIALIZE/QUEUE 

OPEN/QUEUE 

SET QUEUE 

SHOW QUEUE 

START/QUEUE 

STOP/QUEUE 



Assigns a queue to a server 

Closes a queue, preventing it from accepting 
additional entries 

Deassigns a queue from a server, or all 
servers 

Deletes a queue 

Defines a print or batch queue 

Opens a queue, allowing entries to be placed 
on it 

Modifies the attributes of one or more 
queues 

Displays the attributes and status of one or 
more queues 

Starts a queue, allowing entries to be 
routed to servers for processing 

Stops a queue, preventing entries from being 
routed to servers for processing 



+ 



Server- Related 

Deletes a print or batch server 

Defines a print or batch server 

Modifies the attributes of one or more 
servers 

Displays the attributes and status of one or 
more servers 

Starts a print or batch server that was 
stopped 

Stops a print or batch server immediately or 
when the indicated event occurs 



DELETE/SERVER 
INITIALIZE/SERVER 
SET SERVER 

SHOW SERVER 

START/SERVER 

STOP/SERVER 
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Managing the Print/Batch Services Package 

The Print/Batch Services (PBS) package provides several important 
services for RSTS/E users and system managers. The major components 
of PBS are: 

o Queue Manager 

o Print Servers 

o Batch Servers 

o User Interface 

The Queue Manager accepts all user requests, controls all print and 
batch queues, schedules jobs to run, and creates new jobs as needed to 
process requests. 

Print servers process print requests on selected printers. Both line 
printers (LP) and terminals (KB) can be handled by print servers. 

Batch servers control execution of submitted command procedures, using 
the DCL command file processor (see RSTS/E Guide to Writing Command 
Procedures) . You can establish multiple batch servers to process 
several command procedures at the same time. 

The user interface is how an application program communicates with 
PBS. It lets the user program issue requests for print and batch 
services. User Request Packets (see RSTS/E Programming Manual) 
provide this link between PBS and the user application programs. 



Queue Manager 

The Queue Manager module is an integral part of PBS. The term queue 
refers to a list of pending print or batch requests. The term entry 
describes a request on a queue. Normally, PBS adds new entries to the 
end or tail of a queue. PBS processes an entry when it reaches the 
front or head of the queue. 

PBS creates an entry on a queue in response to a user request for 
print or batch services. The entry remains on a queue until its 
requested job is completed, or until it is explicitly deleted by an 
operator or user. PBS assigns a priority to every queue entry which 
establishes its position on the queue relative to other entries. For 
example, PBS inserts a high-priority entry in the queue ahead of 
existing lower priority entries instead of at the end. 
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The system file PBS$:PBS.SYS contains all the queue definitions. You 
define a new queue with the INITIALIZE/QUEUE command. Once you define 
a queue it remains in the file until it is explicitly deleted. You 
delete a queue with the DELETE/QUEUE command. 



Queue Types 

PBS uses two types of queues: 

o Print The PRINT command creates entries in a print queue 

o Batch -- The SUBMIT command creates entries in a batch queue 

You can define several queues for each type, but each queue can only 
have a single type associated with it. Note that once you define a 
queue as a print or batch queue, you cannot change its type. 



Queue Names 

Every queue must have a unique name. This name can consist of 1 to 9 
characters from the set A-Z, 0-9, $, and _, and must begin with an 
alphanumeric character. PBS always forces lowercase characters in 
queue names to uppercase. You need a trailing colon when you include 
the queue name in an entry specification. Otherwise, the colon is 
optional . 

Queue names must be unique, regardless of type. For example, if you 
define a print queue named SYSTEM, then you cannot also define a batch 
queue with the name SYSTEM. 



Default Queues 

You can define one default print queue and one default batch queue. 
When a user issues a PRINT or SUBMIT command and does not specify a 
queue name, PBS places the request on the appropriate default queue. 
You can change default queues at any time by using the SET QUEUE 
command. As distributed, PBS defines the default print queue 
SYS$PRINT and the default batch queue SYS$BATCH . 

You do not have to define default queues. However, if you do not, a 
user must specify the queue on which to place each print or batch 
request . 
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Assigning Servers to Queues 

Once you define a queue, users can submit requests to be placed on 
that queue. You must also indicate which servers are to process 
requests on that queue. You can define servers with the 
INITIALIZE/SERVER command. 

In the simplest configuration, you assign each queue to a single 
server, and you do not assign two queues to the same server. Figure 
9-1 shows this configuration. 

+ + + + 

| Queue LQ | > | Server LPO: | 

+ + + + 

+ + + + 

| Queue BQ | > | Server BAO: | 

+ + + + 



Figure 9-1: One-to-One Configuration 



The one-to-one configuration is useful when users need to have their 
print requests printed on a particular printer or their batch request 
processed by a specific batch server. In such cases, you can choose 
the queue name to match its assigned server's name, such as print 
queue LPO: or batch queue BAO:. 

It may be useful to assign more than one server to a queue, an option 
which is useful when multiple devices with the same characteristics 
exist. For example, at a site with two letter -quality printers (for 
example, KBll: and KB12:), you could define one print queue named LQ 
and assign it to servers controlling each device. Figure 9-2 shows 
this configuration. 



+ + 

| Queue LQ | 
+ + 



+ + 

-> | Server KBll: | 
+ + 

+ + 

■» | Server KB12: | 
+ + 



Figure 9-2; One-to-Many Configuration 



The one-to-many configuration is useful when one class of devices can 
process similar jobs. When a user places a print request on the queue 
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LQ, the first available server assigned to that queue processes the 
request. To balance the use of servers, PBS uses a round-robin method 
to determine which available server to use next. That is, in deciding 
which server to use next, the most recently used server is the last 
one PBS examines. 



You can also assign more than one queue to the same server. For 
example, suppose a batch queue named BAO is currently assigned to 
batch server BAO:, while batch queue BAl is assigned to batch server 
BAl : . If you notice that queue BAO has many entries waiting for 
processing while queue BAl is empty, you can assign queue BAO to both 
servers. Figure 9-3 shows this configuration. 



+ + » + + 

I Queue BAO I | Server BAO: I 



+ + 



+ + 



+ + 



-» + + 



| Queue BAl | | Server BAl: | 
+ + » + + 



Figure 9-3: Many-to-One Configuration 



Note that in Figure 9-3 entries on queue BAl are only processed by 
server BAl:, while entries on queue BAO are processed by either 
server . 

The combination of a one-to-many and a many-to-one configuration is a 
many-to-many configuration. That is, you can assign any set of queues 
to any set of servers. Thus, you have complete control over 
allocating resources (servers) for processing queue entries. 

You can use SHOW QUEUE/FULL command to display the servers assigned to 
a queue. You can use the SHOW SERVER/FULL command to display the 
queues assigned to a server. The ASSIGN/QUEUE and DEAS SIGN/QUEUE 
commands let you assign and deassign each queue's servers. 



Queue Priorities 

You assign each queue a maximum priority and default priority in the 
range 1 to 255. The maximum priority of a queue defines the maximum 
priority a user can specify when issuing a request for that queue. 
The default priority of a queue defines the priority to assign to a 
request issued with no explicit priority specified. These two 
parameters let you set up queues so PBS processes all requests in one 
queue ahead of all requests in another queue. 
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Users with EXQTA privilege can submit PRINT or BATCH requests with a 
priority greater than the queue's maximum. See the section 
"Processing Requests" for more information on processing order. 



Opening and Closing Queues 

Normally, a queue accepts entries even if no servers are available to 
process. the requests. At times, you may want to prevent PBS from 
placing any additional requests on a queue. This is called closing a 
queue; existing entries continue moving toward the front of the queue 
(if there are servers available to process them), but the queue does 
not accept additional entries. You can close a queue with the 
CLOSE/QUEUE command. 

If a user issues a PRINT or SUBMIT command for a closed queue, PBS 
returns an error and rejects the request. You can open a closed queue 
with the OPEN/QUEUE command. 



Starting and Stopping Queues 

Entries move toward the head of a queue, and PBS processes them when 
they reach the queue's head. You can stop a queue with the STOP/QUEUE 
command to prevent any entries on the queue from being processed. 
Users can place additional entries on a stopped queue, but PBS does 
not process them. Any entries currently in process when you stop a 
queue are not affected. You can restart a stopped queue with the 
START/QUEUE command. 

Note the distinction between stopping a queue and stopping a server 
assigned to a queue. When you stop a queue, PBS does not process any 
pending entries on that queue. When you stop a server, PBS does not 
process any pending entries on any queue assigned to that server. The 
two cases are similar in the one-to-one configuration. However, the 
two cases are quite different in a many-to-many configuration. 

For example, if you assign both queues A and B to the same server, 
stopping queue A does not cause that server to become idle, since 
processing can still continue from queue B. However, if you stop the 
server, then processing stops on both queues. 



Processing Requests 

In the one-to-one or one-to-many configurations, PBS always processes 
the entry at the head of the queue. However, when you assign multiple 
queues to the same server, there is no implied order to processing 
entries; all of the entries at the front of each queue are, by 
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definition, eligible for servicing. PBS resolves any conflicts that 
occur by checking the priority and age of the entries. 

When several entries are waiting for processing, PBS chooses the one 
with the highest priority. If several entries have the same priority, 
then PBS selects the one with the earliest entry date and time. 

Before PBS can process an entry, it must be in the READY state. This 
means that the entry: 

o Is not in an AFTER state. An entry can be given an 'after' 
date and time value, which prevents the entry from being 
processed until the specified date and time has passed. 

o Is not in a HOLD state. An entry can also be prevented from 
being processed until an operator or the entry's owner 
explicitly releases it. 

Once an entry is in the READY state, PBS processes it as soon as all 
of the following conditions are met: 

o PBS cannot process any other READY entries of the same type 
but with a higher priority 

o PBS cannot process any other READY entries of the same type 
and the same priority but with an earlier entry date and time 

o A server assigned to the entry's queue is available to 
process the entry. That is, the server is not currently 
processing any other entry. 

o For print entries, a server's controlled device is not 

currently allocated or opened by any other job on the system. 

o For print entries, at least one device is available with the 
entry's required forms installed on it. 

o For batch entries, at least one pseudo keyboard is currently 
available (that is, not allocated to or opened by another job 
on the system) . 

When all of the above conditions are met, PBS starts a print or batch 
job on behalf of the entry. PBS changes the entry's state to STARTED, 
and records the name of the server processing the job in the entry. 
Use the SHOW ENTRY/FULL command to display this information when an 
entry is in process. 

Since PBS always processes print entries and batch entries by 
different servers, entries of a different type never compete with each 
other for processing. 
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Accessing Entries on a Queue 

Users must also be able to locate entries in a queue. PBS provides 
two methods for accessing entries in queues: 

o Entry number -- When PBS adds an entry to a queue as a result 
of the PRINT or SUBMIT command, PBS assigns a unique entry 
number to it. Entry numbers are unique across all queues, 
regardless of type. Thus, each entry has a specific number 
assigned to it, whether it is in a print queue or a batch 
queue. PBS uses this number to record the entry in its queue 
file. 

o Entry specification -- You can also access an entry by 
identifying some or all of the following attributes: 

The name of the entry's queue 

The PPN of the entry's owner 

The name of the entry 

These attributes are permanently established when you create 
the entry; they cannot be modified once PBS adds the entry to 
its queue. 

Several commands (for example, DELETE ENTRY and SHOW ENTRY) 
let you identify an entry or group of entries by specifying 
an entry specification parameter with the command. The 
format of an entry specification is: 

queue -name : [ PPN ] entry -name 

Unlike entry numbers, entry specifications do not uniquely identify an 
entry; several entries with the same attributes can exist at the same 
time. Therefore, be careful when using entry specifications with 
commands to modify or delete queue entries, since doing so can cause 
multiple entries to be modified or deleted inadvertently. 



Job Limits for Queues 

Each queue has maximum and default limits associated with it. For 
print jobs, you can define page limits; for batch jobs, you can define 
both CPU and elapsed time limits. The servers assigned to the queue 
enforce these limits. 

This arrangement lets you set up queues that do not accept requests 
requiring many resources. For example, you could assign a low maximum 
page limit to a queue assigned to a server controlling a slow-speed 
printer, thus restricting requests to relatively small print jobs. 
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Similarly, a queue assigned to a batch server running jobs at low 
priority could accept requests that include large CPU or elapsed time 
limits. 

Users with EXQTA privilege can submit print or batch requests with job 
limits that exceed the maximum limits defined for the queues on which 
their requests are placed. 



Print Servers 

Each print server must have a unique name. PBS always names print 
servers after the devices they control (for example, server LPO: 
controls device _LP0:, server KB45: controls device _KB45:, and so 
on ) . 

Some commands permit wildcard print server names. For example: 

o *: -- Means all servers 

o LP*: -- Means all LP-type servers 

o KB*: -- Means all KB-type servers 

PBS does not allow the question mark character (ASCII 63) in print 
server names. 

PBS associates each entry on a print queue with a form name. This 
name identifies the form that you must install on a printer before the 
server controlling that device can start the job. If you issue a 
PRINT command and do not specify a form name, PBS assigns the form set 
up as the default for the queue on which the request is placed. 



Device Ownership 

A print server can retain ownership of its controlled device and 
prevent other jobs on the system from accessing the device. Use the 
/NOSHAREABLE qualifier with the INITIALIZE/SERVER and SET SERVER 
commands to indicate that the server's device should be permanently 
allocated to PBS. A device so allocated will be deallocated under any 
of the following conditions: 

o An operator changes the server's NOSHAREABLE setting to 
SHAREABLE 

o The device's server is deleted 

o PBS is shut down 



9-10 



Managing Print/Batch Services 



When PBS restarts after a shut down, it attempts to allocate any 
device whose server is marked as NOSHAREABLE. PBS continues to try 
allocating any device that is in use by another job on the system. 
PBS places such a server in the DEVICE-WAIT state indicating that the 
server is trying to gain access to the device. 

If you initialize a server with NOSHAREABLE and its device is not 
available, PBS displays a warning message. PBS allocates the device 
as soon as it becomes available. 

/SHAREABLE indicates that the device can be shared by other jobs on 
the system, and PBS only allocates it when the server starts 
processing a request. The default is /SHAREABLE. 



Job Copies and File Copies 

Each print job consists of one or more files to be printed. 
Qualifiers are available with the PRINT command to specify the number 
of job or file copies to be printed. 

The /JOB_COUNT=n command qualifier specifies the number of copies of 
the job to be printed. The /COPIES=n qualifier specifies the number 
of copies of a file to be printed. The default for both qualifiers is 
one copy. 

If a print job consists of a single file, then the two qualifiers 
produce the same result except for the header pages (see the next 
section "Header Pages"). However, if a print job consists of more 
than one file, then the qualifiers produce different results. 

For example, if you issue the following command: 

PRINT/C0PIES=2 FILE1 . LST , FILE2 . LST 

The order of the job output is: 

Job header (1 of 1) 
File header (1 of 2) 
FILE1 .LST 

File header (2 of 2) 
FILE1.LST 

File header (1 of 2) 
FILE2.LST 

File header (2 of 2) 
FILE2 .LST 
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But, if you issue the following command: 

PRINT/J0B__C0UNT=2 FILEl . LST , FILE2 . LST 

The order of the job output is: 

Job header (1 of 2) 
File header ( 1 of 1 ) 
FILE1 . LST 

File header (1 of 1) 
FILE2.LST 

Job header (2 of 2) 
File header (1 of 1) 
FILE1 .LST 

File header (1 of 1) 
FILE2.LST 



Header Pages 

You can print special job and file header pages to identify the start 
of a job or a file within a stack of listings. Header pages include 
large block letters to help you locate the beginning of job and file 
copies. You can control the number of job or file header pages 
printed by the JOB_PAGES=n and F L AG_P AG E S = n attributes of the printer 
form. 

Header pages consist of fields printed in single -height and 
double -height block letters and other information printed in six 
repeated lines. Three lines are printed at the top and bottom of each 
header page. These lines help you find the start of each job in a 
large listing. 

The job header pages contain the following information: 

o Owner's account name -- This field is in single -height block 
letters 

o Entry name -- This field is in double -height block letters 

o Owner's PPN -- This field is in single -height block letters 

o The three lines at the top and bottom of each job header page 
contain the following: 

Current date 

Current time 

Entry entry- spec 
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Copy nnn of mmm 
Printer device -name 
Form form-name 
Installation-name 

The file header pages contain the following information: 

o Device name and PPN -- This field is in single -height block 
letters 

o Filename -- This field is in double -height block letters 

o File type -- This field is in double -height block letters 

o Owner's PPN -- This field is in single -height block letters 

o The three lines at the top and bottom of each file header 
page contain the following: 

Current date 

Current time 

File filespec 

Copy nnn of mmm 

Printer device-name 

Form form-name 

Installation-name 



Page Limits 

You can limit each print job to a specified maximum number of pages. 
The page limit can be: 

o User specified 

o The default for the queue 

o Unlimited 
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Print servers count the number of pages they print. When a print job 
exceeds its page limit, PBS prints an error on the last page of the 
job listing and terminates the job. Note that header pages do not 
count toward a job page limit. 

When the user specifies the page limit, the value can not exceed the 
maximum limit for the queue. If the user does not specify the page 
limit, PBS uses the default limit of the queue. 



Control Characters and Escape Sequences 

Some printers, such as the LN01 and LA2xx, can understand escape 
sequences. In some cases, the action taken in response to a 
particular escape sequence is device dependent. Therefore, you must 
route files that contain escape sequences to the correct server. This 
is best done by providing queues that assign jobs only to single 
servers or to servers that all serve the same type of printer. 

The /CONTROLS qualifier, provided with the INITIALIZE/SERVER and SET 
SERVER commands, indicates how the server should process control 
characters and escape sequences: 

o /CONTROLS -- Indicates that the server sends control 

characters and escape sequences to its controlled device. 
The action taken is dependent on the device's handling of 
such characters. The print server does not update the form's 
current horizontal and vertical position when sending such 
characters to the printer. 

o /CONTROLS=UP_ARROW -- Indicates that the server translates 
control characters to an 'up arrow' format, consisting of a 
circumflex C ) character followed by a printable character 
that identifies the control character, and that the server 
translates the ESC character to the dollar sign ($), causing 
PBS to display all of the characters in the escape sequence. 
This is the default. 

o /NOCONTROLS -- Indicates that the server does not process 
control characters or escape sequences. PBS discards any 
such characters. 



Note 

Control characters and escape sequences can cause a 
print server to lose track of line and page 
positioning. This is because print servers do not 
know what action is taken by the printer in response 
to such characters. Normally, form feed characters 
correct positioning within a file unless the server . 
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is doing simulated form feed handling. In such 
cases, it may be necessary manually to adjust the 
printer alignment to correct positioning errors 
introduced by control characters and escape 
sequences . 

DIGITAL recommends that servers processing control characters always 
use forms with the NOSIMULATE attribute, to prevent positioning errors 
between jobs. 



Eight-Bit Characters 

PBS passes eight-bit characters unchanged to printers designated as 
eight-bit devices with the SET PRINTER/EIGHT_BIT or SET 
TERMINAL/EIGHT_BIT commands. 



Batch Servers 

Batch servers are named BAn:, where n is a unit number in the range 
0-31. Some commands permit wildcard batch server names, for example: 

o *: -- Means all servers 

o BA* : -- Means all batch servers 

PBS does not allow the question mark character (ASCII 63) in batch 
server names. 



Executing Command Files 

Batch servers use the DCL command file processor on pseudo keyboards 
to create the batch job environment. Batch servers execute a batch 
job by creating a temporary command file. This file: 

o Opens a log file (unless the you specify /NOLOG__FILE with the 
SUBMIT command) 

o Initializes error handling 

o Executes LOGIN.COM files 

o Executes the individual user command files 

PBS passes the parameters you specify with the SUBMIT command only to 
the first command file in the batch job. 
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Because batch servers create their own command procedure to execute 
the user's command files, the number of levels of command nesting that 
PBS allows is one less than the levels available when executing 
command procedures at the interactive level (see RSTS/E Guide to 
Writing Command Procedures). 

The exit status that PBS reports in the batch log file is the status 
of the most severe error occurring in the job, not just the last one. 
The format of the exit status display is: 

Exit status = <message> 

Table 9-2 lists the possible exit status messages. 



Table 9-2: PBS Batch Job Exit Status Messages 

+ + + 

| Message | Meaning | 



Entry cannot 


execute 


• + 

| Job could not be created 


Entry deleted 




| Job was deleted during processing 


Error 




| An error message occurred in the job 


Exceeded CPU 


limit 


| Job exceeded the CPU time limit 


Exceeded time 


limit 


| Job exceeded the time limit 


Severe error 




| A severe error message occurred in the job 


Success 




| No errors or warnings encounted 


Unknown 




| Job logged out or was killed (exit status 
| is unknown) 


Warning 




| A warning message occurred in the job 



CPU and Time Limits 

Batch servers also monitor their batch job to enforce CPU and time 
limits and determine when the job is done. An active batch server 
examines its controlled job's CPU and time usage approximately every 
30 seconds. If either value exceeds the allowable limit for the batch 
job, PBS terminates the job immediately. If you specify a log file 
with the SUBMIT command, PBS includes an error message in the log 
describing the reason for the job termination. 
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Managing Forms for PBS 

Printer forms are the physical paper you install in a line printer. 
In some cases, forms are standard stock paper as normally used for 
printing program listings. In other cases, forms are customized, 
preprinted paper, such as checks or invoices. 

PBS identifies each form by name. A form name consists of 1-9 
characters from the set {A-Z, 0-9, §, _} . PBS converts lowercase 
characters to uppercase. 

When you define a print server, you can specify the name for the form 
currently installed on the server's print device. Each form 
definition includes the form handling characteristics for the printer 
to which it applies. A Forms Definition File (FDF), maintains all the 
form characteristics for each server in PBS (see the next section). 

When you issue a print request, you can specify the form name required 
using the /FORMS=f orm- name qualifier. If you do not include a form 
name, PBS assigns the queue's default form name to the print request. 
PBS verifies that the specified form name is in the FDF. If not, PBS 
returns an error and rejects the print request. 

Before PBS can start a print request, a server assigned to the 
request's queue must be available with the required form installed on 
its printer. If not, the request remains READY until you change forms 
or until you assign a new server with the correct form name to the 
request's queue. 

You can define the same form name differently for different printers. 
For example, NORMAL can have different characteristics for the printer 
LPO : from those it has for LPl : . Generally, the physical dimensions 
of a form page (length and width) should remain the same from one 
printer to another, but the attributes that describe how a printer 
should handle the form may be different, depending on the device. 



Forms Attributes 

PBS defines the following attributes for printer forms: 

o Form name -- A unique 1 to 9 character name that identifies 
the form. 

o Server name - - The name of the server to which the form 
definition applies. This can refer to a single server or 
multiple servers of the same type (LP or KB). 

o Length -- The physical length of a form page, measured in 
lines of print. This value can be in the range 1 to 255. 
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o Width -- The width of a form page, measured in characters 
printed across the page. The value can be in the range 1 to 
255. 

o Job pages The number of header pages to print at the start 
of each new print job. The value can be in the range to 
127. 

o Flag pages The number of flag pages to print at the start 
of each new file within a print job. The value can be in the 
range to 127. 

o Form- feed handling Depending on the form page length and 
the hardware capability, the printer may or may not be able 
to correctly handle FF characters that position the form page 
at the top of the next page. If not, then the server must 
simulate the form feed action by outputting the proper number 
of line feeds to reach the top of the next page. 

o Bottom margin -- The number of lines to skip at the bottom of 
each page. The value must be less than the form page length. 



The Forms Definition File 

PBS provides a Forms Definition File (FDF) to maintain all printer 
form definitions. This file is a standard ASCII stream file, allowing 
anyone with write access to add, delete, and update the form 
definitions using a standard text editor. FDF defines form attributes 
by using keywords (for example, LENGTH=66), to simplify definitions 
further . 

PBS treats lines beginning with an exclamation point (!) as comment 
lines. Thus, you can include descriptions in the definitions file. 

PBS also supports continuation lines. If a definition ends with a 
hyphen (-), the definition is continued on the next line similar to 
the DCL command line continuation feature (see the RSTS/E System 
User ' s Guide ) . 

Note 

If a line to be continued contains a comment, the 
hyphen must precede the comment (see the next section 
"Forms Definition Keywords"). 

Blank lines are ignored. So, you can include blank 
lines where you want to separate definitions for 
readability. 
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The name of the Forms Definition File supplied on the RSTS/E 
distribution kit is PBS$ : FORMS . SYS . As distributed, this file 
contains two definitions for the form named NORMAL: one is for 
LP-class printers and one is for KB-class printers. The file has a 
protection code of <40>, allowing any user on the system to read it; 
however, only users with WWRITE privilege can write to it. 

The default print queue SYS$PRINT is initially set up with NORMAL as 
its default form name. After you install PBS, you can change any of 
these parameters. You can add additional definitions to the file as 
needed . 

The order of form definitions in the FDF is significant. If you 
initialize a print queue and you do not include the /FORMS qualifier, 
PBS defaults to the first form definition. Similarly, if you define a 
print server and do not include the /FORMS qualifier, PBS defaults to 
the first form definition that applies to that server. 

PBS accesses the FDF for the following reasons: 

o When you include a /FORMS qualifier with the PRINT command, 
PBS searches the FDF for the specified form name. 

o When you issue a INITIALIZE/SERVER or SET SERVER command that 
includes a /FORMS qualifier for a print server, PBS searches 
the FDF for the definition of the specified form name. 

o When you issue a INITIALIZE/QUEUE or SET QUEUE command that 
includes a /FORMS qualifier for a print queue, PBS searches 
the FDF for the specified form name. 

If the form name is not found, then PBS returns an error and rejects 
the request. 



Forms Definition Keywords 

A forms definition consists of: 

o Form name 

o Server name 

o One or more keywords that describe the form attributes 

You can use spaces or tabs to separate the keywords within a form 
definition. Any standard RSTS/E line terminator (CR, LF, FF) 
terminates each definition. For example, the definition of the 
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default form named NORMAL for LP-class servers is: 



NORMAL=_LP* : - 

LENGTH=66 - 

WIDTH=132- 

J0B__PAGES=2- 

FLAG_PAGES=2- 

B0TT0M_MARGIN=6 - 

NOSIMULATE 



I form NORMAL for all LP servers 

! 66 lines per page 

! 132 columns per line 

I 2 job header pages 

! 2 flag header pages 

! 6 blank lines at the bottom of each page 

! hardware top-of-form 



If a forms definition applies to a particular server, or class of 
servers, the server name follows the form name and is separated from 
it by an equal sign. The format of the server name in a forms 
definition is: 



form- name [ =server -name [ : ] ] 



PBS does not permit embedded spaces or tabs between the form name and 
the server name. 



The server-name identifies the server(s) to which this definition 
applies. If the definition only applies to a single server, then 
specify the explicit server name. If the definition applies to a 
class of servers (all LP or all KB devices), then specify 
f orm-name=_LP* : or f orm-name=_KB* : (wildcard unit number). If the 
definition applies to all print servers, then specify form-name=*: or 
omit this field from the definition. The default is all servers. 



Note 



If a server belongs to more than one definition for 
the same form, place definitions that apply to 
specific servers before any that apply to a general 
class of servers. PBS searches the FDF sequentially 
until it finds the first occurrence of the requested 
form name with a matching server name. 

You can abbreviate all forms definition keywords to their first two 
characters. Note that the form name always appears first in the 
definition and has no associated keyword. All other fields in the 
definition can be in any order. If a keyword is not included in a 
form definition, then PBS uses the keyword's default value. 

You can include the following keywords in a forms definition: 



LENGTH=n 



Indicates the number of lines per printed page for the specified 
form. The value n can range from 1 to 255. The default length 
is 66; this is standard spacing for an 8-1/2 by 11-inch form with 
vertical spacing of 6 lines per inch. 
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Note 

Some devices that print on single-sheet forms 
cannot print on all physical lines of the form. 
For example, the LN01 prints a maximum of 60 
lines per page. In such cases, the form length 
should be set to the device's maximum print 
lines; not the form's physical size. 

WIDTH=n 

Indicates the maximum number of characters that can appear in a 
printed line for the specified form. The value n can range from 
1 to 255. The default width is 132. 

The WIDTH value determines where a printed line will be truncated 
(if the file is being printed with the /TRUNCATE qualifier of the 
DCL PRINT command in effect) or wrapped around to a new line (if 
the file is being printed with the /NOTRUNCATE qualifier in 
effect ) . 

[NO] SIMULATE 

Determines whether PBS should, on encountering a FF character or 
reaching the end of a page, send a FF character directly to the 
device ( NOSIMULATE ) , or simulate the form feed by transmitting 
the proper number of line-feed characters (SIMULATE). The 
default is SIMULATE. 

JOB__PAGES=n 

Defines the number of job header pages to be printed at the 
beginning of each job listing. The value n can range from to 
127. Job header pages display information about the job (job 
name, PPN, and so forth), printed in large block letters. Job 
header pages make it easy to separate job listings. The default 
is JOB_PAGES=l. 

FLAG_PAGES=n 

Defines the number of file header pages to be printed at the 
beginning of each file listing. The value of n can range from 
to 127. File header pages display information about the file 
(file name, PPN, and so forth), printed in large block letters. 
File header pages make it easy to separate printouts of files 
within a job. The default is FLAG_PAGES=1 . 

Note 

You can suppress the printing of file header 
pages by including the /NOFLAG_PAGES qualifier 
with the file to be printed. 
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BOTTOM__MARGIN=n 

Defines the number of lines to skip at the bottom of each page of 
the form. The bottom margin value cannot exceed the form's 
length. The default is B0TT0M_MARGIN=6 . 

Printers that use single-sheet paper (for example, the LN01) 
automatically end a page and start a new page when it reaches its 
maximum print line. Forms definitions for these devices should 
normally specify BOTTOM_MARGIN=0 . 

Note 

You can suppress the printing of the bottom 
margin by including the /NOFEED qualifier with 
the file to be printed. This has no effect when 
BOTTOM MARGIN=0. 



Changing Forms 

Whenever you need to change forms on a printer under the control of 
PBS, perform the following steps: 

1. Use the STOP/SERVER/JOB_END command to stop the server at the 
end of any current print job. 

2. Use the SHOW SERVER command to confirm that the server is 
stopped and is not processing any print job. 

3. Install the'desired form in the printer. 

4. Use the SET SERVER/FORMS=f orm-name command to assign a new 
form name to the server. Use the SHOW SERVER/FULL command to 
inspect the new form attributes (LENGTH, WIDTH, and so on) as 
needed . 

5. Use the START/SERVER command to restart the server. When you 
issue this command, PBS routes any jobs that are waiting for 
the new form to be installed to the server. 

Note that you can issue a SET SERVER/FORMS=f orm-name command without 
stopping the server, although DIGITAL does not recommended this unless 
the new form definition applies to the same physical form currently 
installed in the printer. Any print job in progress at the time its 
print server is assigned a new form name is not affected. The form 
name last assigned to the server determines the next job to be 
processed by the server. Use the SHOW SERVER command to display the 
name of the form most recently assigned. 
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If you modify the FDF to change the definition of a form name which is 
currently assigned to a server, you must perform a form change (using 
the same form name) to cause the new form definition to be read from 
the FDF. 



Multiple Jobs 

PBS consists of a single primary job and, optionally, one or more 
secondary jobs, depending on the number and use of concurrent print or 
batch servers. PBS is designed to provide a compact and efficient 
package across all of its jobs. This section provides some background 
information on how the PBS package makes use of multiple jobs. 



The Primary Job 

Whenever you issue the START/QUEUE/MANAGER command, PBS creates its 
primary job. This job runs detached. It contains the queue manager 
module and is always present when the package is running. 

The primary job contains two print and two batch server slots. A slot 
refers to a sub-job in the PBS job that provides print or batch 
services. If the number of slots available to support the active 
print or batch servers in the primary job is insufficient, PBS creates 
secondary jobs. 



Secondary Jobs 

PBS creates secondary jobs when there are no print or batch server 
slots available in the primary job to process a waiting request. PBS 
attempts to activate only as many servers as necessary, depending on 
the number of waiting requests ready to run, available devices, and so 
on. Each secondary job contains three print server slots and four 
batch server slots. 

When PBS starts, only the primary job is running. When a pending 
request is ready to start, the queue manager first determines if a 
slot is available on which to activate a server for the request. If 
the primary job contains no available server slots of the correct type 
(print or batch), then PBS automatically creates a secondary job. 

Unlike the primary job, a secondary job remains present only while one 
or more of its server slots is allocated to a server. Once all the 
server slots in a secondary job become free (that is, there are no 
active servers in the job) PBS automatically removes the job from the 
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system. It is possible for several PBS secondary jobs to be present 
on the system at the same time, depending on the number of active 
servers that you require at any time. 

Note 

PBS secondary jobs contain only print and batch 
server slots; they do not contain a queue manager 
module . 

Based on the configuration of PBS, the primary job is sufficient to 
handle two concurrent print jobs and two concurrent batch jobs. If 
more than two print or two batch servers are active at the same time, 
then PBS creates at least one secondary job. Each secondary job 
allows for three more print jobs and four more batch jobs to be 
started. Thus, if your printing volume causes six print devices to be 
active concurrently, you need a total of three RSTS/E jobs (one 
primary and two secondary) to run PBS. 

PBS uses an "idle job timer" to determine when to remove a secondary 
job from the system. The idle job timer is set to five minutes. That 
is, PBS removes a secondary job when all of its servers have been idle 
for five minutes. This time is sufficient for PBS to start a server's 
next job without having to recreate a secondary job. 

PBS creates secondary jobs as needed, as long as job slots are 
available on the system. If none are available, then no secondary job 
is created, and PBS waits until either' a job slot becomes available, 
or an existing server slot becomes free. 

You can limit the number of secondary jobs required by controlling the 
number of servers that can process requests. You can do this by 
deassigning or stopping one or more servers. Idle servers that are 
stopped or not assigned to any queue cannot process a request. Thus, 
they do not require a server slot. 



Descriptions of PBS's DCL Commands 

The following sections contain descriptions of the PBS commands that 
require special privileges. See the RSTS/E System User's Guide for 
descriptions of PRINT, SUBMIT, DELETE ENTRY, SET ENTRY, SHOW ENTRY, 
and SHOW QUEUE commands. 
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ASSIGN/QUEUE Command 

The ASSIGN/QUEUE command assigns a server to a queue. Server 
assignments are cumulative; any server assigned to a queue is added to 
the set of assigned servers. A server named BAn: can only be assigned 
to a batch queue. Likewise, a server named LPn: or KBn: can only be 
assigned to a print queue. ASSIGN/QUEUE command requires PBSCTL 
privilege . 

+ + 

I Format | 

I ASSIGN/QUEUE queue - name [: ] server -name [: ] | 

I Prompts I 

| Queue: queue - name [: ] | 
| Server: server -name [: ] | 
+ + 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be assigned. This command 
does not permit wildcard queue names. 

server -name [ : ] 

Specifies the server to assign to the queue. This command does 
not permit wildcard server names. 
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CLOSE/QUEUE Command 

This command closes a queue; that is, it prevents any additional 
requests from being placed on the queue. If the specified queue is 
not open, RSTS/E ignores this command. CLOSE/QUEUE requires PBSCTL 
privilege. 



Format 

CLOSE/QUEUE queue- name [ : ] 
Prompts 

Queue: queue -name [: ] 



Command Parameters 
queue -name [ : ] 

Specifies the name of the queue to be closed. This command does 
not permit wildcard queue names. 
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DEAS SIGN/QUEUE Command 

The DEASSIGN/QUEUE command deassigns a server from a queue. Any job 
already started on a deassigned server is not affected. However, no 
additional jobs are started on the server from the queue. 
DEASSIGN/QUEUE requires PBSCTL privilege. 

+ + 

| Format j 

j DEASSIGN/QUEUE queue - name [: ] server -name [: ] | 

| Command Qualifiers Defaults j 

I /ALL See Discussion j 

| Prompts | 

| Queue: queue -name [: ] j 
| Server: server -name [: ] j 
+ + 

Command Parameters 

queue- name [ : ] 

Specifies the name of the queue to be deassigned. This command 
does not permit wildcard queue names. 

server -name [ : ] 

Specifies the name of the server to be deassigned. This 
parameter overrides the /ALL qualifier. This command does not 
permit wildcard server names. 

Command Qualifiers 

/ALL 

Indicates that all servers currently assigned to the queue should 
be deassigned. If you specify /ALL, PBS does not prompt for a 
server name. If you specify a server name, PBS ignores /ALL. 
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DELETE/QUEUE Command 

The DELETE/QUEUE command deletes a queue. If you issue DELETE/QUEUE 
for a queue that has one or more entries, RSTS/E marks the queue for 
deletion and closes it. PBS deletes the queue as soon as it becomes 
empty. You can still display queues marked for deletion using the 
SHOW QUEUE command. DELETE/QUEUE automatically deassigns all servers 
from the deleted queue. DELETE/QUEUE requires SWCFG privilege. 

+ - - + 

| Format j 

| DELETE/QUEUE queue - name [: ] j 

| Prompts j 

| Queue: queue -name [: ] j 
+ + 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be deleted. This command does 
not permit wildcard queue names. 
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DELETE/SERVER Command 

This command deletes a print or batch server. If the server you 
specify is currently processing a job when you issue the command, 
RSTS/E marks it for deletion. PBS deletes the server when it becomes 
idle. DELETE/SERVER automatically deassigns the deleted server from 
all assigned queues. DELETE/SERVER requires SWCFG privilege. 

+ + 

| Format | 

I DELETE/SERVER se rve r - name [ : ] | 

| Prompts | 

| Server: server -name [: ] | 
+ + 

Command Parameters 

server -name [ : ] 

Specifies the name of the server to be deleted. This command 
does not permit wildcard server names. 
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INITIALIZE/QUEUE Command 



INITIALIZE/QUEUE defines a print or batch queue and establishes its 
initial properties. Use the SHOW QUEUE command to display the queues 
that are currently defined. See the RSTS/E System User's Guide for 
details on the SHOW QUEUE command. 

When you initialize a queue, you also define its characteristics. 
Print and batch queues have different characteristics. You can modify 
any of a queue's characteristics later by using the SET QUEUE command. 

Note that certain qualifiers for this command apply only to print 
queues, while others apply only to batch queues. An error results if 
you include both types of qualifiers in the same command. PBS uses 
the following criteria to determine whether a queue should be 
initialized as a print queue or a batch queue: 



o If you give a /PRINT or /BATCH qualifier, it determines the 
queue ' s type . 

o If you do not give either /PRINT or /BATCH, but you specify a 
print queue only qualifier (for example, /PAGE_LIMIT) or a 
batch queue only qualifier (for example, /CPU_LIMIT), that 
qualifier determines the queue's type. 

o If you do not meet either of the previous conditions, the 
queue's type defaults to a print queue. 

PBS retains queue information in the queue file when the package is 
shut down. The system uses this information to automatically 
reinitialize queues when it restarts the package. INITIALIZE/QUEUE 
requires SWCFG privilege. 



Format 

INITIALIZE/QUEUE queue - name [: ] 

Command Qualifiers Defaults 

/BATCH See Discussion 

/CLOSE See Discussion 

/CPU_LIMIT=(MAXIMUM=a,DEFAULT=b) See Discussion 

/DEFAULT See Discussion 

/FORMS [ =f orm- name ] See Discussion 

/PAGE_LIMIT=(MAXIMUM=a,DEFAULT=b) See Discussion 

/PRINT See Discussion 

/PRIORITY=(MAXIMUM=a,DEFAULT=b) See Discussion 

/PRIVILEGES=( "priv[ ,...]") /PRIVILEGES=NONE 
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+ 



+ 



Command Qualifiers (Cont.) 



Defaults (Cont.) 



/TIME_LIMIT= ( MAXIMUM=a , DEFAULT=b ) 



See Discussion 



Prompts 



Queue: queue -name [: ] 



+ 



+ 



Command Parameters 
queue -name [ : ] 

Specifies the name of the queue to be initialized. This command 
does not permit wildcard queue names. 

Command Quailifiers 



Indicates that the queue should initially be closed, preventing 
any PRINT or SUBMIT entries from being entered on the queue. By 
default, PBS initializes the queue as open. 

/CPU__LIMIT= ( MAXIMUM=a , DEFAULT=b ) 
/CPU__LIMIT=n 

Batch queues only. Indicates the maximum and default CPU time 
limits (in minutes) for each command file processed in a batch 
job started from this queue. The maximum CPU limit is the 
largest value that you can specify when issuing a request for the 
queue. The default CPU limit is the value that PBS assigns to a 
request that had no limit specified. The keyword UNLIMITED 
indicates that PBS does not enforce a CPU limit. If you do not 
specify the MAXIMUM argument, then PBS uses MAXIMUM=UNLIMITED. 
If you do not specify the DEFAULT argument, then PBS uses the 
maximum CPU limit as the default limit. 

If you use the /CPU_LlMIT=n form, then PBS uses the value you 
specify for both the maximum and default limits. If you specify 
a numeric argument, it must be in the range 1 to 65,535. The 
default CPU limit cannot exceed the maximum CPU limit. 

If you issue a SUBMIT command without an explicit CPU' limit, then 
PBS uses the queue default CPU limit. When you issue a SUBMIT 



/BATCH 



Indicates that the queue is a batch queue, and only accepts 
entries with the SUBMIT command. 



/CLOSE 
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command, you can specify a CPU limit up to, but not exceeding the 
queue maximum CPU limit. 

/DEFAULT 

Indicates that the queue should be marked as the default queue 
for its type (print or batch). You can define only one print 
queue and one batch queue as a default queue. 

If you specify /DEFAULT, then the queue becomes the default queue 
for its type, and any queue currently defined as the default 
queue of the same type no longer serves as the default queue. By 
default, PBS does not mark the queue as a default queue. 

/FORMS= form -name 

Print queues only. Indicates if a default form name is defined 
for the queue. If you specify /FORMS=f orm- name , then PBS defines 
the name you specify as the default form name for the queue. If 
you issue a PRINT command without a /FORMS qualifier, then the 
queue's default form name is the first form name found in the 
FDF. 

/PAGE_LIMIT= ( MAX I MUM = a , DEFAULT=b ) 
/PAGE__L I M I T=n 

Print queues only. Indicates the maximum and default page limits 
for each file printed as part of a print job started from this 
queue. The maximum page limit is the largest value that you can 
specify when issuing a PRINT request for this queue. The default 
page limit is the value assigned to a request for this queue that 
had no limit specified. 

The keyword UNLIMITED indicates that no page limit is enforced. 
If you do not specify the MAXIMUM argument, then PBS uses 
MAXIMUM=UNLIMITED. If you do not specify the DEFAULT argument, 
then PBS uses the maximum page limit as the default limit. 

If you use the /PAGE__LIMIT=n form, then PBS uses the value you 
specify for both the maximum and default limits. If you specify 
a numeric argument, it must be in the range 1 to 4,294,967,295. 
The default page limit can not exceed the maximum page limit. 

If you issue a PRINT command without an explicit page limit, then 

PBS uses the queue default page limit. When you issue a PRINT 

command, you can specify a page limit up to, but not exceeding, 
the maximum page limit of the queue. 

/PRINT 

Indicates that the queue is a print queue and only accepts 
entries from the PRINT command. 
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/PRIORITY= ( MAXIMUM=a , DEFAULT=b ) 
/PRIORITY=a 

Defines the maximum and default priorities for the queue, in the 
range 1 to 255. If you do not specify the MAXIMUM argument, then 
PBS uses 255. If you do not specify the DEFAULT argument, then 
PBS uses the maximum value as the default priority. If you use 
the /PRIORITY=a form, then PBS uses the value you specify for 
both the maximum and default priority. The default priority 
cannot exceed the maximum priority. 

/PRIVILEGES=(priv, . . . ) 

Specifies the set of privileges required for a user to place 
entries on the queue. A user who issues a PRINT or SUBMIT 
command must have all of the queue's privileges for the request 
to be accepted. By default, a user does not need any privileges 
to place an entry on the queue. 

The argument can be any of the RSTS/E privilege keywords, plus 
the keywords ALL and NONE. The /PRIVILEGES=ALL qualifier assigns 
all defined privileges to the queue; /PR I VI LEGES=NONE assigns no 
privileges to the queue. Note that you can specify any privilege 
name with /PRIVILEGES, even those that you do not possess. 

/TIME_LIMIT= ( MAXIMUM=a , DEFAULT=b ) 
/TIME_LIMIT=n 

Batch queues only. Indicates the maximum and default elapsed 
time limits (in minutes) for each command file processed in a 
batch job started from this queue. The maximum time limit is the 
largest value that you can specify when issuing a request for 
this queue. The default time limit is the value that PBS assigns 
to a request that had no limit specified. 

The keyword UNLIMITED indicates that PBS does not enforce a time 
limit. If you do not specify the MAXIMUM argument, then PBS uses 
MAXIMUM=UNLIMITED. If you do not specify the DEFAULT argument, 
then PBS uses the maximum time limit as the default limit. If 
you use the /TIMELIMlT=n form, then PBS uses the value you 
specify for both the maximum and default limits. If you specify 
a numeric argument, it must be in the range 1 to 65,535. The 
default time limit cannot exceed the maximum time limit of the 
queue . 

If you issue a SUBMIT command without an explicit time limit, 
then PBS uses the queue default time limit. When you issue a 
SUBMIT command, you can specify a time limit up to, but not 
exceeding, the maximum time limit of the queue. 
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INITIALIZE/SERVER Command 

The INITIALIZE/SERVER command defines a print or batch server. Use 
the SHOW SERVER command to display the servers that are currently 
defined. See the RSTS/E System User's Guide for details on the SHOW 
SERVER command. 

When you initialize a server, you also define its characteristics. 
Print and batch servers have different characteristics. You can 
modify any of a server's characteristics later by using the SET SERVER 
command . 

PBS retains the server information in the queue file when the package 
is shut down. The system uses this server information to initialize 
servers automatically when you restart the package. This eliminates 
the need to reinitialize servers each time you start PBS. 
INITIALIZE/SERVER requires SWCFG privilege. 



Format 



INITIALIZE/SERVER server -name [ : ] 



Command Qualifiers 

/[NO ] CONTROLS [ =UP_ARROW ] 
/FORMS [ =f orm-name ] 
/PRIORITY=n 
/RUN__BURST=n 
/[NO] SHAREABLE 

Prompts 

Server: server -name [: ] 



Defaults 

See Discussion 
See Discussion 
See Discussion 
See Discussion 
/SHAREABLE 



Command Parameters 



server -name [ : ] 



Specifies the name of the server to be initialized, 
does not permit wildcard server names. 

Command Qualifiers 



This command 



/[NO] CONTROLS [=UP ARROW] 



Print servers only. Indicates how print servers should process 
control characters and escape sequences. The default is 
/CONTROLS=UP_ARROW (see the section "Control Characters and 
Escape Sequences"). 
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You must have PBSCTL privilege to specify this qualifier. 

/FORMS [ =f orm-name ] 

Print servers only. Identifies the form currently installed on 
the printer. The server only prints requests with this form 
name. PBS displays an error message if the form name does not 
exist in the FDF. 

If you omit this qualifier, then PBS initializes the printer with 
the first form definition found in the FDF that applies to the 
specified print server. You can later issue a SET SERVER command 
to assign a different form to the server. 

/PRIORITY=n 

Batch servers only. Indicates the priority at which to run 
command procedures controlled by this server. RSTS/E permits any 
value in the range -120 to +120; however, batch jobs cannot 
exceed the priority of the PBS primary job. RSTS/E rounds the 
priority down to a multiple of 8. The default is -8. 

You must have TUNE privilege to specify this qualifier. 

/RUN_BURST=n 

Batch servers only. Indicates the run burst to assign to any 
command procedures controlled by this server. RSTS/E permits any 
value in the range 1 to 127. The default is 6. 

/[NO] SHAREABLE 

Specifies if the server's device should be shared with other jobs 
on the system. The default is /SHAREABLE. 

If you specify /NOSHAREABLE , RSTS/E immediately allocates the 
device to the PBS job, thereby preventing other jobs on the 
system from gaining access to the device. For batch servers, 
RSTS/E allocates the next available pseudo keyboard to the 
server. The device remains allocated to the PBS job until you 
delete its server (with the DELETE/SERVER command), or you shut 
down PBS (with the STOP/QUEUE/MANAGER command). You get a 
warning message if you specify /NOSHAREABLE for a device 
currently allocated to another job on the system; PBS allocates 
the device when it becomes available. 

If you specify /SHAREABLE, PBS allocates the device only when the 
server is active. The device is available to other jobs when the 
server is idle. The default is /SHAREABLE. 
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OPEN/QUEUE Command 

The OPEN/QUEUE command opens a queue for additional requests after it 
has been closed. If the specified queue is already open, RSTS/E 
ignores this command. OPEN/QUEUE requires PBSCTL privilege. 

+ + 

| Format | 

| OPEN/QUEUE queue -name [: ] j 

| Prompts j 

| Queue: queue - name [: ] j 
+ + 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be opened. This command does not 
permit wildcard queue names. 
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SET QUEUE Command 

The SET QUEUE command modifies the characteristics of one or more 
queues. Changing a queue's characteristic does not affect entries 
already on the queue. SET QUEUE requires PBSCTL privilege. 



Format 

SET QUEUE queue -name [: ] 

Command Qualifiers Defaults 

/ALL See Discussion 

/BATCH See Discussion 

/CPU_LIMIT=(MAXlMUM=a,DEFAULT=b) Attributes are unchanged 

/[ NO ] DEFAULT Attributes are unchanged 

/FORMS [ =form-name ] Attributes are unchanged 

/PAGE_LIMIT=(MAXIMUM=a / DEFAULT=b) Attributes are unchanged 

/PRINT See Discussion 

/PRIORITY= ( MAXIMUM=a , DEFAULT=b ) Attributes are unchanged 

/PRIVILEGES=( "priv[ ,...]" ) Attributes are unchanged 

/TIME_LIMIT= ( MAXIMUM=a , DEFAULT=b ) Attributes are unchanged 

Prompts 

Queue: queue -name [: ] 
+ 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be modified. This command 
permits wildcard queue names. The rules for selecting queues 
when using wildcards are: 

o If you specify /PRINT or a print queue only qualifier, then 
PBS only selects print queues. 

o If you specify /BATCH or a batch queue only qualifier, then 
PBS only selects batch queues. 

o If neither of the above rules are true, then PBS selects any 
queue . 
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Command Qualifiers 
/ALL 

Indicates that all queues should be modified. If you specify 
/ALL, PBS omits the queue name prompt and uses the queue name *. 
If you specify a queue name, PBS ignores this qualifier. 

/BATCH 

Indicates that only batch queues should be modified. When you 
use /ALL with this qualifier, PBS modifies all batch queues. 

/CPU_LIMIT= ( MAXIMUM=a , DEFAULT=b ) 
/CPU_LIMIT=n 

Batch queues only. Indicates the maximum and default CPU time 
limits (in minutes) for each command file processed in a batch 
job started from this queue. The maximum CPU limit is the 
largest value that you can specify when issuing a request for the 
queue. The default CPU limit is the value that PBS assigns to a 
request that had no limit specified. 

The keyword UNLIMITED indicates that PBS does not enforce a CPU 
limit. If you do not specify the MAXIMUM argument, then PBS does 
not change the maximum CPU limit. If you do not specify the 
DEFAULT argument, then PBS does not change the default CPU limit. 
If you use the /CPU_LIMIT=n form, then PBS use the value you 
specify for both the maximum and default limits. If you specify 
a numeric argument, it must be in the range 1 to 65,535. The 
default CPU limit cannot exceed the maximum CPU limit. 

If you do not specify this qualifier, then PBS does not change 
the queue's current default and maximum values. 

/[NO] DEFAULT 

Indicates whether the queue should serve as the default queue for 
its type. If you specify /DEFAULT, then PBS marks the queue as 
the default queue for its type, and any queue already defined as 
the default queue is no longer marked as being the default queue. 
If you specify /NODEFAULT, then the queue is no longer marked as 
being the default queue for its type. PBS does not return an 
error if you specify /NODEFAULT for a queue that is not currently 
marked as the default queue. 

If you do not specify this qualifier, then any current default 
queue is not affected. 
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/FORMS= f o rm - name 

Print queues only. Indicates if a default form name is defined 
for the queue. If you specify /FORMS=f orm-name , then the name 
you specify becomes the default for the queue and replaces any 
previous default form. 

If you do not specify this qualifier, then the queue's current 
default form name is not changed. 

/PAGE_LIMIT= ( MAXIMUM=a , DEFAULT=b ) 
/PAGE_LIMIT=n 

Print queues only. Indicates the maximum and default page limit 
for each file printed as part of a print job started from this 
queue. The maximum page limit is the largest value that you can 
specify when issuing a request for this queue. The default page 
limit is the value that PBS assigns to a request for this queue 
that had no limit specified. 

The keyword UNLIMITED indicates that no page limit is enforced. 
If you do not specify the MAXIMUM argument, then PBS does not 
change the maximum page limit. If you do not specify the DEFAULT 
argument, then PBS does not change the default page limit. If 
you use the /PAGE__LIMIT=n form, then PBS uses the value you 
specify for both the maximum and default limits. If you specify 
a numeric argument, it must be in the range 1 to 4,294,967,295. 
The default page limit can not exceed the maximum page limit. 

If you dot not specify this qualifier, then the queue's current 
default and maximum values are not changed. 

/PRINT 

Indicates that only print queues should be modified. When you 
use /ALL with this qualifier, PBS modifies all print queues. 

/PRIORITY= ( MAXIMUM=a , DEFAULT=b ) 
/PRIORITY=a 

Defines the maximum and default priorities for the queue, in the 
range 1 to 255. If you do not specify the MAXIMUM argument, then 
PBS does not change the current maximum priority. If you do not 
specify the DEFAULT argument, then PBS does not change the 
current default priority. If you use the /PRIORITY=a form, then 
PBS uses the value you specify for both the maximum and default 
priorities. The default priority cannot exceed the maximum 
priority. 

If you do not specify this qualifier, then the queue's current 
default and maximum values are not changed. 
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/PRIVILEGES=(priv, . . . ) 

Specifies the set of privileges required for a user to place 
entries on the queue. A user who issues a PRINT or SUBMIT 
command must have all of the queue's privileges for the request 
to be accepted. PBS accepts any of the RSTS/E keywords, plus the 
keywords ALL and NONE. 

The /PRIVILEGES=ALL qualifier assigns all defined privileges to 
the queue; /PRIVILEGES=NONE assigns no privileges to the queue. 
Note that you can specify any privilege name with /PRIVILEGES, 
even those that you do not possess. 

If you specify this qualifier, PBS replaces the queue's current 
privileges with those in the argument list. If you do not 
specify this qualifier, the queue's current privileges are 
unchanged . 

/TIME__LIMIT= ( MAXIMUM=a , DEFAULT=b ) 
/TIME_LIMIT=n 

Batch queues only. Indicates the maximum and default elapsed 
time limits (in minutes) for each command file processed in a 
batch job started from this queue. The maximum time limit is the 
largest value that a user can specify when issuing a request for 
this queue. The default time limit is the value PBS assigns to a 
request that had no limit specified. 

The keyword UNLIMITED indicates that PBS does not enforce a time 
limit. If you do not specify the MAXIMUM argument, then PBS does 
not change the current maximum time limit. If you do not specify 
the DEFAULT argument, then PBS does not change the current 
default time limit. If you use the /TIME__LIMIT=n form, then PBS 
use the value you specify for both the maximum and default 
limits. If you specify a numeric argument, it must be in the 
range 1 to 65,535. The default time limit cannot exceed the 
maximum time limit. 

If you do not specify this qualifier, then the queue's current 
default and maximum values (if any) are not changed. 
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SET SERVER Command 

The SET SERVER command changes the characteristics of one or more 
servers. Use this command to change forms for print servers. SET 
SERVER requires PBSCTL privilege. 



Format 

SET SERVER server -name [: ] 

Command Qualifiers Defaults 



/ALL See 

/BATCH See 

/[ NO] CONTROLS [=UP__ARROW] Attr 

/FORMS[ =f orm-name ] Attr 

/PRINT See 

/PRIORITY [ =n ] Attr 

/RUN_BURST[=n] Attr 

/[NO] SHAREABLE Attr 

Prompts 

Server: server -name [: ] 



Discussion 
Discussion 
ibutes are 
ibutes are 
Di scussion 
ibutes are 
ibutes are 
ibutes are 



unchanged 
unchanged 

unchanged 
unchanged 
unchanged 



Command Parameters 



server -name [ : ] 

Specifies the name of the server to be modified, 
permits wildcard server names. 

Command Qualifiers 



This command 



/ALL 



Indicates that all servers should be modified. If you specify 
/ALL, PBS omits the server name prompt. If you specify a server 
name, PBS ignores this qualifier. 



/BATCH 



Indicates that only batch servers should be modified. When you 
use /ALL with this qualifier, PBS modifies all batch servers. 
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/[ NO] CONTROLS [=UP__ARROW] 

Print servers only. Indicates how print servers should process 
control characters and escape sequences. If you do not specify 
this qualifier, then PBS does not change the current CONTROLS 
setting. 

/FORMS=f orm-name 

Print servers only. Indicates the name of the form installed on 
the printer. The server only prints requests with the same form 
name. PBS returns an error if the form name you specify for the 
device does not exist in the FDF. 

If you do not specify this qualifier, then the server's current 
form is not changed. 

/PRINT 

Indicates that only print servers are to be modified. When you 
use /ALL with this qualifier, PBS modifies all print servers. 

/PRIORITY! =n] 

Batch servers only. Indicates the priority at which to run 
command procedures controlled by this server. This value cannot 
exceed the priority of the PBS primary job. PBS accepts any 
value in the range -120 to +120. PBS rounds the value down to a 
multiple of 8. 

If you do not specify an argument /PRIORITY, the server's 
priority is set to -8. If you do not specify this qualifier, 
then the batch server's priority is not changed. 

/RUN_BURST[=n] 

Batch servers only. Indicates the run burst to assign to any 
command procedures controlled by this server. PBS accepts any 
value in the range 1 to 127. 

If you do not specify an argument with /RUN_BURST, the server's 
run burst is set 6. If you do not specify this qualifier, then 
the batch server's run burst is not changed. 
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/[NO] SHAREABLE 

Indicates if the device should be made shareable with other jobs 
on the system. 

If you specify /NOSHAREABLE, then PBS immediately allocates the 
device, preventing other jobs from accessing the device. The 
device is deallocated whenever you delete the server (with the 
DELETE/SERVER command) or shut down PBS (with the 

STOP/QUEUE/MANAGER command). If you specify /NOSHAREABLE and the 
device is not currently available, PBS displays a warning message 
and allocates the device as soon as it becomes available. 

/SHAREABLE indicates that the device can be shared by other jobs 
on the system and PBS only allocates it when the server is 
active . 

If you do not specify this qualifier, then the [NO] SHAREABLE 
characteristic is not changed. 
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SHOW SERVER Command 



The SHOW SERVER command displays the status of one or more servers in 
PBS. The display includes information about the server's 
characteristics, its current status, and the queues assigned to the 
server. The SHOW SERVER command requires no privileges. 



Format 

SHOW SERVER [ se rve r - name [ : ] ] 

Command Qualifiers Defaults 

/ALL /ALL 
/BATCH 

/BRIEF /BRIEF 

/FULL 

/PRINT 



Command Parameters 



server -name [ : ] 

Specifies the name of the server to be displayed. If you do not 
specify a server name, all servers are displayed. This command 
does not permit wildcard server names. 



Command Qualifiers 



/ALL 



Specifies that all servers are to be displayed. /ALL is the 
default if no server name is specified. If a server name is 
specified, this qualifier is ignored. 



/BATCH 



Specifies that only batch servers are to be displayed. 



/BRIEF 



Specifies a brief display. It is the default. The brief display 
includes the following information: 



o On-line or Off-line Print servers only. Indicates the 
current status of the server's print device. Note that PBS 
does not detect an off-line device until it attempts to print 
on it; all devices are assumed to be on-line when PBS first 
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starts. KB-type printers are considered off-line when an 
XOFF (CTRL/S) characters causes the device to stall for an 
extended period of time. 

o Active -- Indicates that the server is currently processing a 
request . 

o Idle Indicates that the server is not currently processing 
a request. 

o Stopped Indicates that the server is currently stopped and 
will not accept any new requests. The server may or may not 
be active. 

o Job-wait -- Indicates that PBS is unable to create a 

secondary job because no job slots are currently available. 
PBS will keep trying to create the second job until it 
succeeds . 

o Device-wait -- Indicates that PBS is unable to allocate a 
device because the device is not available. For print 
servers, device-wait means that the printer controlled by the 
server is allocated to or opened by another job. For batch 
servers, device-wait means that no pseudo - keyboards are 
currently available. PBS will keep trying to allocate the 
device until it succeeds. 

o Shareable or Non- shareable -- Print servers only. Shareable 
means that the print device is available to other jobs on the 
system when it is not in use by the server. Non - shareable 
means that the print device is permanently allocated to the 
server. 

o Form name -- Print servers only. Indicates the name of the 
forms currently installed, or "No forms" if no forms are 
installed. 

/FULL 

Specifies a full display. The full display includes all of the 
information in the brief display, and also includes the following 
information: 

o Current entry -- If the server is active, PBS displays the 
entry number and entry spec of the current entry. 

o Assigned queues -- PBS displays a list of the queues which 
can route requests to the server. 

/PRINT 

Specifies that only printer servers are to be displayed. 
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START/QUEUE Command 

The START/QUEUE command starts a queue that was stopped with the 
STOP/QUEUE command. Once you start a queue, PBS processes waiting 
entries on the queue. If you already started the specified queue, PBS* 
ignores this command. START/QUEUE requires PBSCTL privilege. 

+ - - - + 

| Format j 

| START/QUEUE queue - name [: ] j 

| Prompts I 

j Queue: queue -name [: ] j 
+ - - + 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be started. This command does 
not permit wildcard queue names. 
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START/QUEUE/MANAGER Command 

The START/QUEUE/MANAGER command starts PBS. Following this procedure, 
it: 

1. Creates the PBS primary job as a detached job running in the 
user's account. RSTS/E initializes the job's priority and 
run burst according to the package configuration parameters. 



2. Compresses the PBS system file by removing any records that 
are marked as deleted. (This step reduces the overall size 
of the file.) During this step, if RSTS/E finds an entry with 
status STARTED, it retains the entry, placing it on HOLD. 
This can happen if RSTS/E restarts the package after a system 
crash . 



3. Loads all queue definitions into memory from the PBS system 
file. 



4. Loads all server definitions into memory from the PBS system 
file. If a print server device is not a valid device on the 
system, PBS marks the server DISABLED. 

5. Assigns servers to queues based on the assignment information 
maintained in the PBS system file. 

6. Attempts to permanently allocate a device for any server 
marked as NOSHAREABLE in its server's definition. If the 
allocation fails because the device is currently in use, PBS 
marks the server DEVICE-WAIT and attempts to allocate the 
device periodically until the allocation succeeds. 

7. Confirms start-up has successfully completed by displaying a 
message. 



The start-up process can take from a few seconds to several minutes, 
depending on the number of pending requests in the queue. Most users 
include the START/QUEUE/MANAGER command in their system start-up 
command file so the time required for PBS start-up is added to normal 
system start-up time. START/QUEUE/MANAGER requires PBSCTL privilege. 



+ 



+ 



Format 

START/QUEUE/MANAGER 
Command Qualifiers 



Defaults 



/PRIORITY=n 
/RUN BURST=n 



+ - 



/PRI0RITY=-8 
/RUN BURST=6 



- - + 
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Command Qualifiers 
/PRIORITY=n 

Specifies the priority of the detached PBS job and any secondary 
jobs that PBS creates. Value must be in the range -120 to +120; 
with any value specified rounded down to a multiple of 8. The 
default is - 8 . 

/RUN__BURST=n 

Specifies the run burst of the detached PBS job and any secondary 
jobs that PBS creates. Value must be in the range 1 to 127. The 
default is 6. 
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START/SERVER Command 

This command restarts a server that was stopped with the STOP/SERVER 
command. If the server has a stalled job when you issue the command, 
the command either resumes the job or terminates it, depending on the 
qualifiers you use. 

For print servers, the job can be resumed at a specified page of the 
current file copy. PBS ignores this command if the specified server 
is already started. For batch servers, PBS releases the controlled 
batch job from its held state. START/SERVER requires PBSCTL 
privilege . 



Format 

START/SERVER server -name[ : ] 

Command Qualifiers 

/BACKSPACE [=n] 

/FORWARDSPACE [ =n ] 

/NEXT_JOB 

/PAGE=n 

/RESTART 

/TOP_OF_FILE 

Prompts 

Server: server -name [: ] 



Defaults 

See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 



Command Parameters 



server -name [ : ] 



Specifies the name of the server to be started, 
does not permit wildcard server names. 

Command Qualifiers 



This command 



/BACKSPACE [=n] 



Print servers only. Indicates that printing should resume n 
pages back in the current file listing. If you do not include an 
argument, then printing resumes one page before the current page. 
If you specify an argument that extends beyond the beginning of 
the file, then printing resumes at the beginning of the current 
file copy. 



PBS ignores this qualifier if the specified server is idle. 
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/FORWARDSPACE [ =n ] 

Print servers only. Indicates that printing should resume n 
pages forward in the current file listing. If you do not include 
an argument, printing resumes one page after the current page. 
If you specify an argument that extends beyond the end of the 
current file, printing resumes at the next file copy, if any. 

PBS ignores this qualifier if the specified server is idle. 

/NEXT_JOB 

Indicates that the current job should be aborted and printing or 
batch processing should resume at the next job, if any. 

PBS ignores this qualifier if the specified server is idle. 

/PAGE=n 

Print servers only. Indicates that printing should resume at 
page n in the current file listing. If you specify an argument 
that extends beyond the end of the file, printing resumes at the 
next file copy, if any. A value of 1 indicates the first page of 
the file; PBS does not include header pages in the count. 

PBS ignores this qualifier if the specified server is idle. 

/RESTART 

Print servers only. Indicates that printing should resume at the 
beginning of the current job copy. If you submit the job with a 
/JOB_COUNT qualifier argument larger than one, PBS only starts 
the current job copy. 

PBS ignores this qualifier if the specified server is idle. 
/TOP_OF_FILE 

Print servers only. Indicates that printing should resume at the 
beginning of the current file copy. If the file being printed 
was submitted with a /COPIES qualifier argument larger than one, 
PBS only starts the current file copy. 

PBS ignores this qualifier if the specified server is idle. 
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STOP QUEUE Command 

The STOP/QUEUE command stops a queue; that is, PBS prevents any 
pending requests on the queue from being processed. Any requests that 
are currently being processed are not affected. STOP/QUEUE requires 
PBSCTL privilege. 

PBS ignores this command if the specified queue is already stopped. 

+ + 

| Format | 

| STOP/QUEUE queue -name [: ] | 

| Prompts | 

| Queue: queue - name [: ] | 
+ + 

Command Parameters 

queue -name [ : ] 

Specifies the name of the queue to be stopped. This command does 
not permit wildcard queue names. 
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The STOP/QUEUE/MANAGER command lets you shut down PBS, either 
immediately (causing all currently active jobs to be terminated) or 
when all servers become idle. STOP/QUEUE/MANAGER requires PBSCTL 
privilege. 

You can shut down PBS in two ways: 



o As part of normal system shutdown. The SHUTUP program 

includes a phase for automatically shutting down PBS, either 
immediately or when all print or batch jobs currently in 
progress complete. 

o Manually, using the STOP/QUEUE/MANAGER command. 



+ - - + 

Format 

STOP/QUEUE/MANAGER 

Command Qualifiers Defaults 

/[NO] ABORT /NOABORT 
+ 



Command Qualifiers 



/[NO] ABORT 



Indicates whether any print or batch jobs currently running 
should be aborted before shutting down PBS. Use /ABORT to shut 
down PBS immediately; use /NOABORT to let all currently running 
print or batch jobs complete. The default is /NOABORT. 
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STOP/SERVER Command 

This command stops a print or batch server. The action taken depends 
on whether the server is currently active or not. For queues that are 
assigned to only one server, stopping the server is equivalent to 
stopping the queue. For queues that are assigned to more than one 
server, stopping one server does not prevent requests from being 
routed to other active servers. STOP/SERVER requires PBSCTL 
privilege . 

If you issue a STOP/SERVER command for a server that is not currently 
processing a request, no additional requests are routed to that 
server. However, if you issue a STOP/SERVER command for a server that 
is currently processing a request, the following action is taken 
depending on the server: 

o Batch servers -- If you specify the /JOB__END qualifier, PBS 
lets the current batch job complete before stopping the 
server. Otherwise, the server suspends the batch job by 
assigning it a priority of -128. The server then waits until 
PBS issues a START/SERVER command to either resume or 
terminate the batch job. 

o Print servers -- If you specify the /PAGE__END, /FILE__END or 
/JOB_END qualifier, PBS does not stop the server until it 
completes the current page, file copy, or job copy. If the 
copy is the final copy of the job, PBS lets the job finish 
before it stops the server. If you do not specify any of the 
qualifiers, PBS stops the server immediately. 

When PBS directs the server to stop, the server stops sending 
data to the printer. However, system buffers continue to be 
printed on the device until they become empty. This is 
necessary to prevent PBS from losing proper page positioning 
on the printer. The server then waits until you issue a 
START/SERVER command to either resume or terminate the print 
job. 
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+ 



+ 



Format 



STOP/SERVER se rve r - name [ : ] 



Command Qualifiers 



Defaults 



/FILE_END 
/JOB_END 
/PAGE END 



See Discussion 
See Discussion 
See Discussion 



Prompts 



Server: server -name [: ] 



+ 



+ 



Command Parameters 
server-name[ : ] 

Identifies the server to be stopped. This command does not 
permit wildcard server names. 

Command Qualifiers 

/FILE_END 

Print servers only. Indicates that printing should stop after 
the current file copy is finished printing. 

Note that this qualifier conflicts with /JOB_END and /PAGE_END . 
/JOB_END 

For print servers, indicates that printing should stop after the 
device has finished printing the current job. For batch servers, 
indicates that the server should stop when the current batch job 
completes . 

Note that this qualifier conflicts with /FILE_END and /PAGE_END. 
/PAGE_END 

Print servers only. Indicates that printing should stop at the 
end of the current page. 

Note that this qualifier conflicts with /FILE_END and /JOB_END. 
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Managing System Errors 



The RSTS/E monitor automatically logs both hardware and system level 
software errors. To gain the full advantages of this error detection 
capability, you must use the programs in the System Error Package. 
These programs fall into three main categories: 

o Extraction and retention of system errors 

o Extraction and retention of system errors not yet retrieved 
at the time of a system crash 

o Compilation and formatting of saved system errors 

When the monitor detects an error, routines save critical 
error - related data and send a message to the ERRCPY program. The 
system invokes ERRCPY, which then retrieves the saved data, performs 
minimal error message processing, and stores the error information in 
a specially formatted disk file ( ERRLOG . FIL ) . Because RSTS/E limits 
the number of messages that may be queued to ERRCPY, it should be run 
at a higher priority than most jobs to prevent the loss of valuable 
diagnostic information. A separate program, ERRINT, initializes and 
validates the error logging file to minimize the size of ERRCPY. 
Normally, you run ERRINT at the beginning of system start-up to start 
ERRCPY. 

When a system crash occurs and the system crash dump facility is 
enabled, the monitor preserves the contents of certain critical parts 
of the system in the system file [0,1] CRASH. SYS. Run the ANALYS 
program immediately following the recovery from a system crash to 
extract and format key information from the crash file. Normally, 
this is done by the system start-up command file. One of the 
functions ANALYS performs is the creation of a separate error logging 
file (by default, ERRCRS . FIL ) containing errors that were not 
processed by ERRCPY at the time of the crash and an ERRDIS report for 
the errors. 
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Use of the Error Logging Programs: ERRINT and ERRCPY 

The system program ERRCPY reads error - related information stored in 
the monitor part of memory and writes it to a special disk file called 
ERRLOG.FIL. The error file initialization and validation program 
(ERRINT) starts the ERRCPY program. ERRINT performs various file 
checking or generation functions and chains to ERRCPY. You must make 
sure the commands are in the START.COM file to start ERRINT (thus, 
ERRCPY) and that ERRCPY is active during time-sharing operations. 



Error Logging Initialization: ERRINT 

When the RSTS/E system starts up, DCL executes commands in the 
START.COM command file. The following command starts ERRINT: 

$ RUN ERR0R$ : $ERRINT 

When the system executes the previous command, the ERRINT program 
tries to locate the error file ERRLOG.FIL. If it finds the file, 
ERRINT checks certain critical control information in the file. If 
this information is invalid, ERRINT renames the file ERRLOG.TMP, 
generates and initializes a new ERRLOG.FIL, and issues an 
informational message: 

Error File was found to be Invalid 

Error File was generated and Invalid File renamed ERRLOG.TMP 

If ERRINT does not find ERRLOG.FIL, it generates and initializes the 
file. 

Two other commands, corresponding to responses to ERRINT questions, 
must also be present in the command file. The two ERRINT dialogue 
questions for which you must include responses are: 

Change size to < 100 >? 

Utilize crash file output (YES/NO) <N0>? 

Once ERRINT validates or creates ERRLOG.FIL, it prints a message 
telling you what percentage of the file has been used. For example: 

ERRLOG file is 8% full 

ERRINT also prints a question that includes (in angle brackets) the 
maximum number of blocks allowed for the file: 

Change size to < 100 >? 

You can accept the current size of the file (originally 100 blocks) or 
change the maximum size if you want. You can also specify an optional 
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switch, /LOCK. If you include /LOCK in your response, ERRCPY runs 
nonswappable. The default is that ERRCPY can be swapped out. 

Note 

You should only specify /LOCK if your system has over 
128K words of memory. 

The program then asks if you want to append the contents of the 
special error crash file ERRCRS.FIL to the contents of ERRLOG.FIL in 
the question: 

Utilize crash file output (YES/NO) <NO>? 

If you answer YES, ERRINT tries to find the file and add its contents 
to the end of the main error logging file. If it cannot find the 
error crash file, ERRINT ignores the command and continues. 

After it finishes processing all of its functions, ERRINT detaches and 
chains to ERRCPY. At this point, the terminal on which ERRINT started 
is free for other use. 

The ERRINT program is usually located in the error library account 
ERROR$ . To run ERRINT from this account, type RUN ERROR$ : ERRINT and 
press RETURN. 

You can run ERRINT only if ERRCPY is not currently running. If you 
start up ERRINT while ERRCPY is running, then when ERRINT chains to 
ERRCPY, the new version of ERRCPY hibernates and displays the message: 

?Name or account now exists at line 1025 in "ERRCPY" 

Note that the version of ERRCPY that was running in a detached state 
on the system continues to run. 



Examples of ERRINT Dialogue 

An example of the ERRINT dialogue follows: 

$ run errors : errint<RET> 
ERRINT V9.0 RSTS V9 . EDERE 
ERRLOG file is 8% full 
Change size to < 100 >? 120<RET> 

Utilize crash file output (YES/NO) <NO>? NO<RET> 
Detaching 

In this example, a valid error log file exists, has a maximum length 
of 100 blocks, and is 8% full. If you change the maximum size to 120 
blocks but decide not to add the special ANALYS error log file to the 
ERRINT error log file, the program detaches and chains to ERRCPY. 
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In the next example, ERRINT finds an invalid error log file, renames 
the invalid file to ERRLOG.TMP, creates a new file, leaves the maximum 
size at 100 blocks, and attaches the special error log file ERRORS . FIL 
to the error log file ERRLOG . FIL . Note that the 2% full message 
indicates a file containing only control information; this is the 
state of a newly generated error log file: 

$ run er ror$ : er rint<RET> 
ERRINT V9.0 RSTS V9 . EDERE 
Error file was found to be invalid 

New file was generated and invalid file renamed ERRLOG.TMP 
ERRLOG file is 2% full 
Change size to < 100 >?<RET> 

Utilize crash file output (YES/NO) <NO>? YES<RET> 
Detaching 



Error Logging: ERRCPY 

You can start the ERRCPY program only by running ERRINT. ERRCPY runs 
detached, processes incoming error messages, and writes each message 
as a variable - length record to a nonspanned sequential file 
( ERRLOG . FIL ) . When its message queue is empty, ERRCPY enters the 
receiver sleep state and may be swapped out. 

The monitor queues messages to ERRCPY regardless of the presence or 
absence of ERRCPY. (If ERRCPY is not running, the messages are simply 
left waiting, up to a limit of 40.) The first message the monitor 
queues on start-up is always a "power fail/start up" message. On 
receiving a special error message from the SHUTUP program, ERRCPY logs 
the message, closes the error file, and kills itself. 



Displaying Errors: ERRDIS 

The error display program ERRDIS provides you with a convenient method 
of displaying previously logged errors. 

ERRDIS has four functions: 

o Provides a summary report by error type and unit number 
(where applicable) of all errors logged to the error file 

o Provides a detailed report of one or all error types logged 
between any two user - selected date and time pairs 
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o Zeros the contents of the error file following the generation 
of a report 

o Provides a list of potentially bad disk blocks 

ERRDIS consists of two modules: ERRDIS and ERRDET. The first module 
performs the first and third functions. To perform the other 
functions, ERRDIS chains to ERRDET; control returns to ERRDIS when 
ERRDET finishes processing. 



Running ERRDIS 

You can run the ERRDIS program by typing: 

$ RUN ERROR$ : ERRDIS 

ERRDIS V9.0 RSTS V9 . EDERE 

After ERRDIS prints header information, you select optional modes of 
operation by means of an interactive dialogue. In the dialogue 
description shown in Table 10-1, prompts are numbered for reference. 
An answer enclosed in angle brackets (<>) indicates the default 
response; select the default by pressing RETURN in response to a 
program prompt. You can abbreviate most responses with two 
characters. Optional characters are enclosed in square brackets []; 
for example, HE [ LP ] . 



Table 10-1: ERRDIS Dialogue Explanation 

+ + + 

j Step | Prompt and Description | 
+ + + 



1 



ERRDIS V9.0 RSTS V9 . EDERE 

ERRDIS prints an identification line. 



2 



Input File <[0,3]ERRLOG.FIL>? 

Enter a file specification for ERRDIS to process. The file 
must be formatted as an error logging file. 



3 



Output to <KB: ERRDIS. OUT>? 

Enter a file specification to which ERRDIS should send the 
report . 
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Table 10-1: ERRDIS Dialogue Explanation (Cont.) 



+ 



+ 



Step | 



Prompt and Description 



+ 



+ 



4 



He[lp], Ba[d Blocks], Su[mmary) or Fu[ll] Report <Summary>? 



| Select one of four possible reports: 

| o He[lp]. Prints help a file, followed by a list of 

| mnemoni cs cor responding to all possible error types. 

! o Ba[d Blocks]. Outputs a report of possible bad blocks 

I detected from the disk errors logged in the input file 

| entered in Step 2. 

| o Sufmmary], Outputs a report of the number of errors 

| detected for each error type and for each unit number 

| within a specific error type. The next dialogue step 

| is 10. 

| o Fu[ll]. Outputs a report of the detailed contents of 

| each selected error record in the error file. 

| Selection of a specific record depends on the answers 

| to steps 5 through 9 in the ERRDIS dialogue. 

5 | Specific Error Type <All>? 

| Enter a two - character mnemonic identifying the specific 

| error type that you want ERRDIS to process. The default 

I answer selects all error types. Note that if you select 

| All, you may also attach the /NOTAPE switch if you want 

| magnetic tape errors to be omitted from the error listing. 

6 | Starting Date <First Error>? 

I Enter the date of the earliest error that you want ERRDIS 

j to process. The format is dd-mmm-yy. The default answer is 

| the date of the first error in the error log file. If you 

| press RETURN to select the default, the next step is 8. 

7 | Starting Time <First Error>? 

| Enter the time of the earliest error that you want ERRDIS 

| to process. The format is hh:mm. The default is the time of 

| the first error in the error log file on the selected date. 

8 | Ending Date <Last Error)? 

| Enter the date of the latest error that you want ERRDIS to 

| process. The format is dd-mmm-yy. The default is the date 

| of the last error in the error log file. If you select the 

| default, then the next dialogue step is 11. 



10-6 



Managing System Errors 



Table 10-1: ERRDIS Dialogue Explanation (Cont.) 



Prompt and Description 




Ending Time <Last Error>? 

Enter the time of the latest error that you want ERRDIS to 
process. The format is hh:mm. The default is the time of 
the last error in the error log file on the selected ending 
date. The next dialogue step is 11. 

List Bad Blocks (Yes/No) <No>? 

Press RETURN (or type No) if you do not want ERRDIS to 
generate a list of possible bad blocks following the 
summary report. Type Yes if you want a list of bad blocks. 

Zero Error File upon completion (Yes/No) <No>? 
Type Yes to have ERRDIS zero the previously specified error 
log file after it successfully generates the desired 
report. (You must type all three characters of Yes to zero 
the file . ) 



After you finish the dialogue, ERRDIS: 

o Processes the selected error records 

o Formats and generates the selected report 

o Zeros the error log file (if requested in step 11 of Table 
10-1 ) 



o Returns to step 2 of Table 10-1. 

At that point, you can enter CTRL/Z in response to any question to 
return the terminal to the keyboard monitor prompt. 



Help Report 

The Help report prints information on the use of the ERRDIS program 
and then prints a list of the error mnemonics other programs use. 
After you run ERRDIS and select the Help report, the program prints 
the Help text. 



Summary Report 

A summary report at the end of this section supplies general 
information on all errors logged. The first two columns list the 
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two- character error mnemonic and full error description. The TOTAL 
REC/LOG column lists the total errors received by the ERRCPY program 
and the total it stored in the error file. These two totals may 
differ due to the limits on: 

o The number of errors that may be logged 

o The size of the error file 

The UNIT NUMBERS column lists the total number of errors generated by 
each device on a controller. 

The CONTROLLER ERRORS column indicates how many of the errors logged 
under TOTAL REC/LOG are controller errors, as opposed to unit errors. 
(Controller errors apply to the controller itself, while unit errors 
apply to a specific unit being controlled. ) If N/A appears under 
CONTROLLER ERRORS, that means that ERRDIS is not keeping track of 
CONTROLLER ERRORS for that particular ERROR CODE - DESCRIPTION . 

The asterisk (*) next to 239/100 indicates that MM, under the ERROR 
CODE - DESCRIPTION column, has exceeded the maximum number of errors 
(100) that the Error Package logs for that particular error type. 

After you run ERRDIS and select the SUMMARY report, the program prints 
the summary as follows. Note that the Summary Report now contains 
fewer blank lines, to compress the display: 

$ RUN ERROR$ : ERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File < [ , 3 ] ERRLOG . FIL> ? <RET> 
Output to <KB : ERRDI S . OUT> ? <RET> 

He[lp], Ba[d Blocks], Su[mmary] or Fu[ll] Report <Summary>? <RET> 
List Bad Blocks (Yes/No) <No>? <RET> 
Zero Error File upon completion (Yes/No) <No>? <RET> 
ERRDIS Summary Report taken on 29-May-85, 10:50 AM 

Input File: { , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 
Reported Date/Time Range: 
13-May-85, 12:21:22 AM through 28-May-85, 12:35:47 AM 



ERROR TOTAL UNIT NUMBERS CONTROLLER 

CODE -DESCRIPTION REC/LOG 01234567 ERRORS 

PF Power Fail/Start-up 1/1 N/A 

DU MSCP Disks 7/7 i 2 1 3 

DB RH11/RP04-05-06 3/3 3 N/A 

DL RL01/RL02 3/3 1 2 N/A 

MM RH11/TU16/TE16 * 239/100 49 7 5 2 37 N/A 

SH MSG from SHUTUP 1/1 N/A 



Total of 115 Errors Logged out of 254 Received 

34 out of 100 Blocks have been used in [ , 3 ] ERRLOG . FIL 
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************************************************************ 
Input File < [ , 3 ] ERRLOG . FIL> ? ~Z 

$ 



Bad Block Report 

The ERRDET program reports possible bad blocks that were detected by 
the monitor by checking the error logging file for such entries. The 
criteria for a possible bad block depends on the type of disk. 

Each bad block report includes: 

o The logical block number 

o The logical name or pack identification of the disk 

o The physical device name of the disk 

Using the logical block number that ERRDIS prints, you can add the 
possible bad block to the bad block file with the BADS suboption of 
REFRESH. See the RSTS/E System Installation and Update Guide for 
information on adding bad blocks. 

The following example shows a list of bad blocks that the ERRDIS 
program prints: 

$ RUN ERROR$ : ERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File <[ / 3]ERRLOG.FIL>? <RET> 
Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? BAD BLOCKS <RET> 
Zero Error File upon completion (Yes/No) <No>? <RET> 
ERRDIS Bad Block Report taken on 29-May-85, 10:51 AM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDI S . OUT 
Requested Date/Time Range: 

First Error through Last Error 
[ , 3 ] ERRLOG . FIL will not be zeroed upon completion 



List of Possible Bad Blocks: 



Logical Name RAIDER 

Physical Name DM1 : 

Logical Block Number 3401 

Logical Name OFTHE 

Physical Name DR4 : 
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Errors 



Logical Block 



Numbe r 



237968 



Logical Name 
Physical Name 
Logical Block 



Number 



LOST 
DR5: 
432952 



Logical Name 
Physical Name 



ARK 
DM2 : 



Logical Block Number 8 

Total Number of Possible Bad Blocks: 4 

************************************************ 
Input File < [ , 3 ] ERRLOG . FIL> ? ~Z 



Adding Bad Blocks to the Bad Block File 

The ERRDIS program prints a list of potential bad blocks. If you 
decide to add a block to the bad block file BADB.SYS on a disk, use 
the BADS suboption of the REFRESH option in INIT.SYS (see the RSTS/E 
System Installation and Update Guide). In preparation for adding bad 
blocks, which requires you to bring the system down, use the PIP 
system program to copy the data in a bad file to a new file. As your 
system discovers bad blocks, PIP lets you collect this information in 
a single file. You can then use this file to add the bad blocks to 
BADB.SYS when you normally take your system down. 

Follow these steps to use PIP for this purpose: 

1. Specify the /GO switch (along with other necessary switches, 
such as /CL, and so forth) to ignore possible ?Data error on 
device errors. Rename the file that contains the bad block, 
but do not delete it: 



Note 



Use caution before adding possible bad blocks (that 
ERRDIS reports) to the bad block file. Instead of 
corrupt disk surfaces, hardware controller or disk 
drive problems may have caused the errors to occur. 



$ RUN $PIP 



*FILE . TMP=FILE . OLD/GO 
*FILE . BAD=FILE . OLD/RE 
*FILE . OLD=FILE . TMP/RE 
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2. When it is convenient, shut down the system and use the BADS 
suboption of REFRESH to add any bad blocks to the disk's bad 
block file. Each new bad block is now allocated to two files 
([0,1] BADB . SYS and FILE. BAD in the previous example). 

3. The BADS suboption automatically rebuilds the allocation 
tables. It then tells you the file has a bad block and 
allows you to delete the file (FILE. BAD in the previous 
example). The RSTS/E Installation and Update Guide describes 
this operation. 

When BADS deletes the file, it frees the blocks in the file that are 
not bad. 

You must modify the previous procedure if the bad block is in a file 
directory. In this case, use the BACKUP (or SAVE/RESTORE) program to 
copy all accessible files in the account (or disk) to an archive 
medium. When you add the bad block and clean the disk, you can delete 
the account whose directory contains the bad block. After starting 
timesharing, use SAVE/RESTORE to restore the entire disk, or use 
BACKUP to restore the files from the archive medium. 

The bad block report does not apply to MSCP disks; bad blocks on those 
devices are recovered automatically. 



Full Report 

Each error displayed includes: 

o A title line containing the error code mnemonic 
o The error description 
o A sequence number 

o The date and time the error occurred 

The monitor maintains the sequence numbers, starting at one, from 
start-up to shutdown. A crash and subsequent automatic restart does 
not reset these numbers. 

There are four basic categories for individual errors displayed within 
the full error report: 

o Nonperipheral errors such as processor traps and memory 
parity • 

o Disk errors 
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o Nondisk peripheral device errors such as magnetic tape errors 

o Other errors such as the shutdown message received from 
SHUTUP or missed errors 

The program automatically checks for and reports possible bad blocks 
for disk errors included in the scan. The following sections contain 
partial listings of a FULL report. 

When the monitor detects a hardware or software error, it sends 
information about the error to the ERRCPY program. ERRCPY can accept 
and file error information until the number of queued errors reaches 
40. The monitor logs all errors it detects beyond this point as 
"missed errors." Only after the queue begins to empty and the number 
of errors queued to ERRCPY falls below the maximum of 40 can the 
monitor begin to send the normal error information. This means that 
while the queue is full, the monitor reports all subsequent errors as 
"missed errors," rather than sending the usual error information to 
ERRCPY. 

The monitor also reports missed errors if it does not have a 
sufficient number of general small buffers available to store error 
information. When the number of general small buffers drops below 75, 
the monitor reports any detected error to ERRCPY as a "missed error." 



User Description in Full Report 

All errors except shutdown, missed errors, and some MSCP controller 
errors usually include a user description. The name fields in the 
user description relate to a specific job whose number appears in the 
first field (Job number). (Under certain conditions, a job number of 
is possible. In this case, the user description is not listed.) 

The following example shows a complete error report for a tape device; 
the report includes both a user description and a detailed 
description: 

$ RUN ERROR$ : ERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File < [ , 3 ] ERRLOG . FIL>? <RET> 
Output to <KB : ERRDI S . OUT> ? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 

Specific Error Type <All>? <RET> 

Starting Date <First Error>? 13-May-85 <RET> 

Ending Date <Last Error>? <ret> 

Zero Error File upon completion (Yes/No) <No>? <RET> • 

ERRDIS Full Report (All Types) taken on 29-May-85, 02:17 PM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 
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Requested Date/Time Range: 

13-May-85 (First Error) through Last Error 
[ , 3 ] ERRLOG . FIL will not be Zeroed upon completion 

***************************************************** 

MM RH11/TU16/TE16 Seq #92 Occurred on 28-May-85 at 02:11:44 PM 

User Description: 

Job Number 18 

KB Number 2 

Account [1,170] 

Program Name PASIKO 

User Job Physical Addr. 02310000 

User Job Size 28K 

Control Parameters 200 

RTS Name RTll 

RTS Physical Address 01714000 

Detailed Description: 

Timeout Indicator 000 
Physical Name MM0 : 



DDB 



017600 
045471 
000000 
000056 



173444 
005171 
147240 
002004 



104252 
001630 
000000 
127311 



000011 
177400 
001007 



CSR Address: 



176700 



Contents of Registers: 



MTCS1 


145270 


TRE Xfer Err 


MTWC 


000400 




MTBA 


132444 




MTFC 


000000 




MTCS2 


000100 




MTDS 


150660 


PE Mode 


MTER 


100000 


COR/CRC 


MTAS 


000001 




MTCK 


000000 




MTMR 


000000 




MTDT 


000000 


TU77 TM03 


MTSN 


000000 




MTTC 


000000 




MTBAE 


000016 




MTCS3 


002000 





Table 10-2 summarizes the user description data. 
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Table 10-2: User Description Data 



+ 



Heading 



Meaning 



Job Number 



KB Number 

Account 
Program Name 



User Job Physical 
Address 

User Job Size 



Control Parameters * 
RTS Name 

RTS Physical Address 



For disk errors, the number of the job that 
requested the I/O; for nondisk peripheral 
errors, the job owning the device; for 
nonper ipheral errors, the job running at 
the time of the error. 

The keyboard number of the job, followed by 
DET if the job is detached. 

The PPN of the user who created the job. 

The name of the program running in the job 
virtual address space (low segment). 

The current physical memory address of the 
job . 

The size of the user program running in the 
low segment of the job virtual address 
space . 

Monitor control information. 

The name of the run- time system mapped into 
the highest segment of the user's virtual 
address space. 

The address of the location in physical 
memory where the run-time system resides. 



* A detailed description of this entry is beyond the scope of this 
manual. The entry is intended for use by DIGITAL personnel. 



Disk Error Detailed Description 

A FULL report for a disk error includes three sections: 
o User description 
o Detailed description 
o Contents of register 
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Table 10-3 describes the information found in the detailed description 
portion of a disk error report. Before you refer to the table, study 
the following example. The example shows what a single complete disk 
error looks like. If the entire Full Report of DB type errors were 
reproduced here, you would see two more identically structured error 
messages following this one. As you can tell from the sample in the 
section "Summary Report," there are three DB errors under TOTAL 
REC/LOG. The example follows: 

$ RUN ERROR$ : ERRDI S <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File < [ , 3 ] ERRLOG . FIL>? <RET> 
Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 
Specific Error Type <All>? DB <RET> 
Starting Date <First Error)? 13-May-85 <RET> 
Starting Time <First Error>? <RET> 
Ending Date <Last Error)? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DB only) taken on 29-May-85, 11:00 AM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 

Requested Date/Time Range: 

13-May-85 (First Error) through Last Error 
[ , 3 ] ERRLOG. FIL will not be Zeroed upon completion 

******************************************************** 

DB RH11/RP04-05-06 Seq #81 Occurred on 28-May-85 at 07:12:14 AM 

User Description: 



Job Number 17 

KB Number 33 (Det) 

Account [ 1 , 100 ] 

Program Name LOGOUT 

User Job Physical Addr. 02744000 

User Job Size 11K 

Control Parameters 200 

RTS Name . . .RSX 

RTS Physical Address 00000000 

Detailed Description: 



I/O Status 000 

Timeout Indicator 000 

Offset Position Previous 

Overlapped Seek Ind. 377 

Unit Size in DCs 121510 

Device Cluster Size 8 

Pack Cluster Size 8 

Logical Name D 

Physical Name DB2: 

Logical Block Number 19272 
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DSQ 



WCB 



FCB 



CSR Address: 



004500 173442 

045501 006171 

000000 146300 

000056 002004 

100000 004442 

146274 000000 

113570 004550 

005166 005413 

147040 070560 

064511 077430 

001300 113570 

000011 000226 

176700 



104252 000011 

064540 174000 

000000 001000 

127310 001003 

000002 000021 

000000 001310 

004551 005165 

005414 005415 

000544 076725 [1,100] 

037404 000001 TEMP33.TMP 

001270 113570 

000010 146300 



Contents of Registers: 



RPCS1 145270 TRE Xfer Err 

RPWC 000400 

RPBA 000 000 

RPDA 000000 

RPCS2 000000 

RPDS 000000 Not Ready 

RPER1 000000 

RPAS 00 000 

RPLA 000000 

RPMR 000000 

RPDT 000000 

RPSN 000000 

RPOF 000000 

RPDC 000000 

RPCC 000000 

RPER2 000000 

RPER3 000000 

RPEC1 000000 

RPEC2 000000 



Table 10-3 describes the information found in the detailed description 
portion of the previous disk error report. The program prints an 
additional field if the error signalled a possible bad block. 
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Table 10-3: Disk Error Detailed Description 



Heading 

I/O Status 
Timeout Indicator 



Offset Position 



Meaning 



See following Timeout Indicator. 

Timeout and I/O Status are considered as a 
pair. One of the following states can 
exist : 



Timeout 
Indicator 



I/O 
Status 



Meaning 



Idle 

SEEK in progress 
Waiting for 
Read/Write 
Timeout 



where x equals any nonzero value. 

The contents of Offset Position for disks 
having offset capabilities: 








centerline position 


20 




+x offset 


220 




-x offset 


40 




+2x offset 


240 




-2x offset 


60 




+3x offset 


260 




- 3x offset 


100 




offset unknown 



Overlapped Seek Ind 



Unit Size in DCs 

Device Cluster Size 
Pack Cluster Size 



where x equals the number of micro inches 
of offset (a drive type parameter). 

377 = overlap seek driver 
000 = non-overlap seek driver 

You determine which of these two values 
appears during system installation. 

Size (in octal) of the disk expressed as 
the number of device clusters. 

Device cluster size for this drive. 

Pack cluster size for this disk. 
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Table 10-3: Disk Error Detailed Description (Cont.) 



Heading 



Logical Name 



Physical Name 
Logical Block Number 
DSQ* 
WCB* 

FCB* 

CSR Address 

Contents of Registers 



Meaning 

The pack identification if no system wide 
logical name was given at mount time or 
the system logical name entered at mount 
time . 

The physical name and unit number. 

The block number where the error occurred. 

The disk request queue entry block. 

The WCB (Window Control Block) is present 
for disk errors that resulted from a file 
request by the user job. 

The File Control Block. 

The CSR address is the base address of the 
set of registers in the I/O page belonging 
to the device that caused the error. 

This section contains the name of each 
readable device register, its contents 
and, possibly, an abbreviated description 
of various error bits that were found to 
be set to one in the register. ERRDIS 
stores a maximum of 21 error bits for each 
error type . The data file ERRDAT.FIL 
contains the register mnemonics, error bit 
descriptions, and error code descriptions 
for all error types. ERRDIS requires this 
file to run. 

See the PDP-11 Peripherals Handbook for a 
detailed description of registers and bit 
descriptions. The register mnemonics 
displayed by ERRDIS correspond to those 
given in the manual. 



A detailed description of this entry is beyond the scope of this 
manual. The entry is intended for use by DIGITAL maintenance 
personnel . 
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MSCP Variations on the Full Report 

For systems that support MSCP type disk hardware, (for example, the 
RA80), there are two variations on the Full Report: 

o If there is a disk error, then the Full Report looks just 
like the normal Full Report, except that it has an extra 
section called the MSCP Description (see Example #1). 
Therefore, the Full Report includes the following four 
sections: 

User Description 

Detailed Description 

Contents of Registers 

MSCP Description 



o If there is a controller error, then the Full Report shows an 
abbreviated error message. The Full Report does not have a 
User Description, and its Detailed Description is not as 
large as in the normal Full Report (see Example #2). The 
Full Report includes the following three sections: 

Detailed Description 

Contents of Registers 

MSCP Description 



If you refer back to the sample report in the section "Summary 
Report," you will notice that the first example that follows is the 
error that was logged under UNIT NUMBER 1. The second sample error 
message that follows is one of the three errors logged under 
CONTROLLER ERRORS. 

Example #1: 

$ RUN ERROR$ : ERRDI S <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File <0,3]ERRLOG.FIL>? <RET> 
Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 
Specific Error Type <All>? DU <RET> 
Starting Date <First Error>? <ret> 
Ending Date <Last Error>? <ret> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DU only) taken on 29-May-85, 02:17 PM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 



10-19 



Managing System Errors 



Requested Date/Time Range: 

First Error through Last Error 
[ , 3 ] ERRLOG. FIL will not be Zeroed upon completion 



******************************************************* 

DU MSCP Disks Seq #46 Occurred on 28-May-85 at 02:35:39 PM 



User Description: 



Job Number 


12 






KB Number 


16 






Account 


[1,217] 






Program Name 


PACKID 






User Job Physical Addr. 


01610000 






User Job Size 


7K 






Control Parameters 


000 








R a Q A V 






RTS Physical Address 


01514000 






Detailed Description: 








I/O Status 


000 






Timeout Indicator 


377 






Offset Position 


000 






Overlapped Seek Ind. 


000 






Unit Size in DCs 


000000 






Device Cluster Size 









Pack Cluster Size 









Logical Name 








Physical Name 


DU7 : 






Logical Block Number 


200806 






DSQ 


000000 


177430 


103664 




001424 


010147 


000367 




023000 


000400 


000010 




000000 


000000 


075576 




000003 


004000 


000000 




003777 






CSR Address: 


160414 







Contents of Register: 



SA 000000 Controller On Line 

) 
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MSCP Description: 
Packet Type 



End Message 



MSCP Envelope 


000060 


000001 






MSCP Packet 


074130 


140416 


000007 


000000 




000203 


000043 


000736 


000000 




000000 


000000 


001624 


000000 




020424 


001003 


031431 


020144 




000007 


000000 


000037 


000001 




000001 


003400 


000020 


002001 


Command Reference Number 


074130 


140416 







Drive Number 
Message Flags 
End Flags 
Endcode 

Status/Event Code 
First Bad Block 



000007 
000 
000 
203 

000043 
031431 



GET UNIT STATUS command 
No vol mntd or r/s switch out 
020144 



Example #2: 

$ RUN ERROR$ : ERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File < [ , 3 ] ERRLOG. FIL>? <RET> 
Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 
Specific Error Type <All>? DU <RET> 
Starting Date <First Error>? <RET> 
Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DU only) taken on 29-May-85, 02:19 PM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 

Requested Date/Time Range: 

First Error through Last Error 
[ , 3 ] ERRLOG . FIL will not be Zeroed upon completion 



************************************************************ 
DU MSCP Disks Seq #2 Occurred on 19-Apr-85 at 12:21:22 AM 



Detailed Description: 

I/O Status 
Timeout Indicator 



000 
377 



CSR Address: 



172150 



10-21 



Managing System Errors 



Contents of Register 
SA 000000 



Controller On Line 



MSCP Description: 
Packet Type 
MSCP Envelope 
MSCP Packet 



Controller Class 
Controller Model 
Controller Hardware Version 
Controller Software Version 
UDA Internal Error Code 



Last Fail 
000030 000020 



000000 
000400 
000000 

001 
006 
000 
004 

000013 



000000 
000012 
000406 



000000 
000000 
000004 



000000 
000000 
000013 



Mass Storage 
UDA50-A 



ER.MST 



Bus Master Error 



Nondisk Peripheral Device Error Detailed Description 

Table 10-4 lists the fields found in the detailed description portion 
of the nondisk peripheral device error report. Before you refer to 
the table, study the following example. The example shows a single 
complete tape error. As you can tell from the example in the section 
"Summary Report," this is one of the 239 tape errors that were 
received. This particular error was one of the 100 logged, and also 
one of the seven logged under UNIT NUMBER 1. The entire Full Report 
contains 99 more tape error messages. The example follows: 

$ RUN ERROR$ : ERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File <[0,3]ERRLOG.FIL>? <RET> 
Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 
Specific Error Type <All>? MM <RET> 
Starting Date <First Error>? <RET> 
Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (MM only) taken on 29-May-85, 02:17 PM 

Input File: [ , 3 ] ERRLOG. FIL Output File: KB : ERRDIS . OUT 

Requested Date/Time Range: 

First Error through Last Error 
[ , 3 ] ERRLOG . FIL will not be zeroed upon completion 

********************************************************* 

MM RH11/TU16/TE16 Seq #44 Occurred on 28-May-85 at 05:51:08 AM 
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User Description: 



Job Number 

KB Number 

Account 

Program Name 

User Job Physical Addr 

User Job Size 

Control Parameters 

RTS Name 

RTS Physical Address 



11 

33 (Det) 

[1,100] 

BACKUP 

02610000 

15K 

200 

. . .RSX 

00000000 



Detailed Description: 



Timeout Indicator 


000000 








Physical Name 


MM1 : 








DDB 


000016 


000426 


002102 


100001 




000001 


000000 


000000 


000000 




105536 


120540 


010004 


000021 




000361 


001002 


010760 


000053 




000000 


007314 


004400 




CSR Address: 


172440 









Contents of Registers: 



MTCS1 


145260 


TRE Xfer Err 


MTWC 


000000 




MTBA 


010004 




MTFC 


000000 




MTCS2 


000100 




MTDS 


150760 


PE Mode 


MTER 


100000 


COR/CRC 


MTAS 


000001 




MTCK 


000010 




MTMR 


001100 




MTDT 


142011 


TU16/TE16 


MTSN 


060023 




MTTC 


102301 





Table 10-4 describes the information found in the detailed description 
portion of the previous nondisk peripheral device error report 
example . 
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Table 10-4: Nondisk Peripheral Device Format 



Heading 



Meaning 



Timeout Indicator 

Physical Name 
DDB* 

DDB* Extension 
CSR Address 

Contents of Registers 



Nonzero indicates that an expected 
response was not received from the device 
in the allotted time. 

The physical name and unit number of the 
devi ce . 



The DDB (Device Data Block) 
various parameters required 
to control the device. 



contains 

by the system 



Supplementary DDB information. 

The CSR address is the base address of the 
set of registers in the I/O page belonging 
to the device that caused the error. 

This section contains the name of each 
readable device register, its contents 
and, possibly, an abbreviated description 
of various error bits that were found to 
be set to one in the register. ERRDIS 
stores a maximum of 21 error bits for each 
error type. The data file ERRDAT . FIL 
contains the register mnemonics, error bit 
descriptions, and error code descriptions 
for all error types. ERRDIS requires this 
file to run. 

See the PDP-11 Per ipherals Handbook for a 
detailed description of registers and bit 
descriptions. The register mnemonics 
displayed by ERRDIS correspond to those 
given in the manual. 



* A detailed description of this entry is beyond the scope of this 
manual. The entry is intended for use by DIGITAL maintenance 
personnel . 



Nonper ipheral Error Detailed Description 

See the related processor handbook for detailed descriptions of 
nonper ipheral error fields. Table 10-5 gives an abbreviated 
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description of these items. Before you refer to the table, study the 
following example. This example shows a single complete error message 
extracted from the ERRLOG.FIL using ERRDIS to reproduce only the PF 
type errors: 

$ RUN ERROR$ rERRDIS <RET> 
ERRDIS V9.0 RSTS V9 . EDERE 

Input File <[ 0,3]ERRLOG.FIL>? <RET> 
Output to <KB : ERRDIS . OUT> ? <RET> 

Help, Bad Blocks, Summary or Full Report <Summary>? FULL <RET> 
Specific Error Type <All>? PF <RET> 
Starting Date <First Error>? <RET> 
Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (PF only) taken on 29-May-85, 02:21 PM 

Input File: [ , 3 ] ERRLOG . FIL Output File: KB : ERRDIS . OUT 

Requested Date/Time Range: 

First Error through Last Error 
[ , 3 ] ERRLOG . FIL will not be zeroed upon completion 



*********************************************************** 

PF Power Fail/Start-up Seq #1 Occurred on 13-May-85 at 02:15:01 PM 

Detailed Description: 



R0 


000000 


Rl 


004200 


R2 


000000 


R3 


000002 


R4 


004100 


R5 


000000 


Virtual PC 


000077 


Physical PC 


00000077 


Processor Status 


000000 


Stack Pointer 


002074 


(SP) 


000002 


(SP+2) 


000000 


(PC-6) 


034156 


(PC-4 ) 


004356 


(PC-2) 


034156 


(PC) 


004357 


CPU ID 


-1 


CPU ERR 


000000 



Table 10-5 describes the information found in the detailed description 
portion of the previous example. 
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Table 10-5: Nonper ipheral Error Format 



Heading 



Meaning 



R0-R5 

Virtual PC 

Physical PC 

Processor Status 

Stack Pointer 

(SP) 
( SP+2 ) 

(PC-6) 
(PC-4) 
(PC-2) 
(PC) 

CPU ID 
CPU ERR 
MED X 

Contents of Registers 



Processor registers through 5. Each 
register is listed on a separate line. 

The address (within the user virtual 
address space) of the instruction being 
executed at the time of the error. 

The address (in the physical memory 
address space) of the instruction being 
executed at the time of the error. 

The processor status word. 

The address of the current top of stack. 

The contents of the top two words in the 
stack . 

The contents of the three words preceding 
the current program PC and the contents of 
the current PC. 



If it exists, the contents of the CPU 
identification register. 

If it exists, the contents of the CPU 
error register. 

If it exists, the CPU has Maintenance 
Examine/Deposit Instruction. 

Certain nonper ipheral errors include 
contents of key registers. The format is 
identical to the contents of registers for 
disk and nondisk peripheral errors. 



+ 



Note 

The PF error code is used for recording both start-up 
and power fail recovery. The error log for a normal 
start-up has a sequence number of 1. For a power 
fail restart, the sequence number is greater than 1. 
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Analyzing System Crashes: ANALYS 

Time-sharing operations halt when a crash occurs on a RSTS/E system. 
The system then writes an image of read/write memory, tables, and XBUF 
to the CRASH. SYS file in account [0,1]. The system bootstraps the 
system disk, loads the initialization code into memory, and executes 
an automatic restart if the CPU switch register has bit set. 

Unless you run the ANALYS program to save crash dump information, the 
next system crash causes the CRASH. SYS file to be overwritten and the 
information in the file to be lost. Normally, this is done as part of 
system start-up. See Chapter 2 for a description of automatic system 
recovery procedures. 

The crash analysis program ANALYS consists of four modules: 
O ANALYS 
O ANALY1 
O ANALY2 
o ANAL Y 3 

For simplicity, the documentation refers to only one program, ANALYS, 
which functionally includes the four modules. 



Running the ANALYS Program 

Run the ANALYS system program by typing the command: 

$ RUN ERRORS :ANALYS<RET> 

After you press RETURN, the ANALYS program prints an identification 
line and three dialogue questions: 

ANALYS V9.0 RSTS V9 . EDERE 
INPUT < [ , 1 ] CRASH. SYS>? <RET> 
OUTPUT <ANALYS.DMP>? <RET> 

Crash error log f i lename< [0,3] ERRCRS . FIL> ? <RET> 
$ 

Table 10-6 explains how to answer the ANALYS program questions. 
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Table 10-6: ANALYS Program Dialogue 



+ 

! Question and Response 



INPUT < [ 0,1 ] CRASH. SYS>? 

Asks for the name of the file to be analyzed. Type the file 
specification of the file you want ANALYS to analyze, which 
by default is CRASH. SYS in account [0,1]. Press RETURN to 
accept the default response. However, you may want to keep 
copies of different crash files. 

ANALYS uses the currently installed monitor SIL file to 
extract symbolic references. If the crash file being 
analyzed is not associated with the currently installed 
monitor, you must append the /SIL: switch with the name of 
the related monitor SIL. This switch allows DIGITAL to 
analyze crash and .SIL files submitted with a Software 
Performance Report (SPR). 

OUTPUT <ANALYS . DMP> ? 

Requests a disk file or a device designator for the output 
medium. You can select the default output file ANALYS. DMP by 
pressing RETURN. Enter another file specification if you do 
not want ANALYS to place the output in the default account. 
ANALYS always prints an annotated version of a memory dump 
and automatically prints a memory dump in 132-column format 
unless you: 

o Request output to your terminal (for example, 
KB: ANALYS .DMP) . 

o Append the /NARROW switch to a file specification (or 
type /NARROW and press RETURN in response to the OUTPUT 
question if you want ANALYS. DMP to be the output file). 

o Append the /NOSTB switch to produce a quick analysis 
report. Do not use this switch when submitting an SPR. 

In either case, you get the annotated output in 80-column 
format, but with fewer memory locations printed on each 
line. If you do not want a dump of memory, append the 
/NODUMP switch to your response. 
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Table 10-6: ANALYS Program Dialogue (Cont.) 
+ - - - - 



I Question and Response 

+ 



Crash error log f ilename< [0,3] ERRORS . FIL>? 

Asks for the file specification of the file you want to hold 
certain error information from the crash file. Press RETURN 
to have ANALYS write this information to the ERRORS. FIL in 
the error package account [0,3]. 

Note that the /DET qualifier causes ANALYS to detach. 

ANALYS retrieves error information saved at the time of a 
system crash but not written to the system error logging 
file ERRLOG.FIL. The ERRDIS program accepts the file you 
specify as input and produces an error log report from its 
contents. To retain a single continuous error logging file, 
use an ERRINT option. 
+ 

Normally, ANALYS takes more than 15 minutes to run. When the output 
stops, the program automatically terminates and returns to the 
keyboard monitor prompt. 



ANALYS Output 

Output of the ANALYS system program supplies valuable hardware and 
software information that a software specialist can use to determine 
possible causes of system crashes. It includes: 

o A report similar to SYSTAT 

o A memory dump of the critical contents of memory 

o A listing of all monitor symbols 

The report also contains DECnet/E information if you configured your 
system with DECnet/E. See the RSTS/E Utilities Reference Manual for 
an explanation of SYSTAT. 

Table 10-7 shows the error codes that ANALYS reports in the crash dump 
data . 
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Table 10-7: System Crash Error Code 

+ + + 

| Error Code (Octal) | Meaning | 



-1(177777) 


--- + - 

| Power fail error. 




-2(177776) 


| Jump to . 




-3(177775) 


| This code is returned when RSTS/E does a 
| crash dump as a result of halting the CPU 
| continuing from location 52 (octal). 


and 


-4(177774) 


| This code is returned when RSTS/E detects an 
j unrecoverable problem and forces a software 
| crash. 


41 


j Trap to 4. 




42 


| Trap to 10. 




43 


| Trap to 250 (Memory management violation) 




44 


j Kernel SP Stack overflow. 




46 


| Trap to 114 (Parity memory error). 
--- + 





To obtain crash information printouts automatically, include the 
proper commands in the START.COM file. The commands run ANALYS to 
preserve the crash information and run ERRDIS to create a report. See 
Chapter 3 for a description of the commands you should include in the 
START.COM file. 
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Device Management and Caching Control 



This chapter introduces the concepts of device management and caching 
control on your RSTS/E system. Later, it explains DCL commands 
available to you in more detail. Table 11-1 summarizes these .DCL 
commands . 



Table 11-1: DCL Commands for Device Management and Caching Control 



Command 



Meaning 
Device Management 



ALLOCATE 

DEALLOCATE 
SET DEVICE 
SET PRINTER 

SHOW DEVICE 
SHOW DISKS 
SHOW PRINTER 



| Allocates a device and optionally assigns it a 

| logical name 

i Deallocates the specified device 

I 

| Sets the characteristics for the specified device 

i 

| Set the characteristics of the specified line 

| printer 

I 

| Displays information about the specified device 

I 

| Displays the status of all mounted disks 

| Displays the characteristics of the specified 

j printer 



Caching Control 


SET CACHE 


j Enables data and directory 


caching 


SHOW CACHE 


i 

| Displays the current cache 


settings 
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Principles of Device Management 

The SET DEVICE command can be used for all devices that were allowed 
under the SET option of INIT. You need HWCTL privilege to use the SET 
DEVICE command. See the RSTS/E System Installation and Update Guide 
for a description of the SET option. 

You can disable a specific device for the current time-sharing session 
with the /DISABLE qualifier to the SET DEVICE command. To disable a 
device for subsequent sessions, use the SET DEVICE command in the 
START.COM file. To reenable a disabled device, use the /ENABLE 
qualifier. 

The /RESTRICT qualifier limits the use of the specified device to 
users with DEVICE privilege. The /NORESTRICT qualifier lets any user 
allocate or open the specified device. 



Optimizing Disk Directory Structure: REORDR 

The REORDR program can restructure the disk directories on your system 
to improve disk access time. This process begins once you run REORDR 
and answer the set of questions in its dialogue. The following 
sections discuss: 

o Operations that REORDR performs 

o REORDR dialogue 

o Restructuring the public disk structure 

o Example of the entire process 



Why Use REORDR? 

The system catalogs RSTS/E files on disk in user file directories 
(UFD). As you create, delete, and extend files, the file directory 
entries become scattered across the surface of the disk. This 
scattering increases both the time to open files and the time to 
retrieve data blocks. 

The REORDR program can perform three operations to restructure disk 
directories. Each of these operations can improve the performance of 
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your system. After you run the program and answer a sequence of 
dialogue questions, REORDR performs the following: 

1. Places the list of file names in as few physical disk blocks 
as possible. This reduces the number of directory accesses 
the system needs to make for a file open operation. 

2. Attempts to place all directory information concerning the 
physical location of file data (retrieval pointers) for a 
file into contiguous disk blocks. This reduces the number of 
disk directory accesses required to perform disk read and 
write operations. 

3. Optionally sorts the file name list in one of four ways, 
depending on how you answer the dialogue questions. This 
reduces the number of directory accesses the system needs to 
make for a file open operation. 

When RSTS/E creates a new file in an account, it adds the file name at 
the end of the current directory list. That is, RSTS/E places files 
last in the directory if, during disk initialization, you typed NO to 
the DSKINT question NEW FILES FIRST (see the RSTS/E System 
Installation and Update Guide). This ordering, while not efficient 
under most situations, may be more efficient for your installation. 
You should have new files first only if users on your system do not 
create many new files and their accounts are not large. Otherwise, 
because of the way RSTS/E retrieves user directory information, it is 
more efficient to have new files last. With the REORDR program, you 
can choose to organize files by access date or creation date. 

Note that because DCL always has its work file open while you are 
logged in, you normally cannot reorder your own account's directory on 
the system disk. 



Dialogue Questions and Responses 

The REORDR program prints a set of questions after you type RUN 
AUXLIB$ : REORDR: 

$ RUN AUXLIB$ : REORDR 
REORDR V9.0 RSTS V9 . EDERE 

Sort Directory(s) (YES/NO) <NO>? YES 

Order by CRE [ ATION ] or ACC[ESS] Date<CRE>? <RET> 

In FOR [ WARD ] or REV[ ERSE ] Order<FOR>? <RET> 

Device and UFD Specif ication( s ) ? DBl :[*,*], DB2 :[*,*] 
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Table 11-2 summarizes these questions and their responses. 
Table 11-2: REORDR Dialogue Questions 

+ • 

| Question and Response 

+ ■ 

Sort Directory(s) (YES/NO) <N0>? 

Type NO or press RETURN to keep the existing order of the 
account(s) you are processing. Either response causes REORDR 
to skip the next two questions. 

Type YES to have REORDR sort the account(s) you designate. 
REORDR asks the next two questions to determine how you want 
the account(s) sorted. 

Order by CRE [ ATION ] OR ACC[ESS] Date<CRE>? 

Type CRE or press RETURN to have REORDR sort the account(s) 

by creation date. 

Type ACC to have REORDR use ACCESS date to sort the 

account(s). Depending on how the disk was initialized, the 

access date can have one of two meanings. It can mean: 

o When the file was last accessed 

o When it was last modified 

Note that the abbreviation DLW in the comments part of the 
disk status report of SYSTAT or the VT50PY program shows 
that a disk's access date is set to the date of last 
modification. 

In FOR [ WARD ] or REV[ ERSE ] Order<FOR>? 

Type FOR or press RETURN if you want REORDER to sort oldest 
files first. 

Type REV to have REORDR create a sorted file with newest 
files first. 
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Table 11-2: REORDR Dialogue Questions (Cont.) 

+ + 

| Question and Response | 
+ + 

Device and UFD Specif ication( s ) ? 

Enter the device mnemonic ( s ) and unit number (s) of the 
device(s) you want REORDR to process. Include the account(s) 
you are reordering with the device designator. For example, 
the specification DBO : [ 1 , 210 ] ,DB1 : [ * , 210 ] is a valid 
response. Although SY: (indicating the entire public 
structure) is not a valid device, SYO : (indicating the 
system disk, the device that was bootstrapped) is acceptable 
for the device response. An asterisk (*) is a valid 
character in either or both of the pro ject -programmer 
account fields. It tells REORDR to process all project or 
all programmer numbers on the device. You can also include 
multiple specifications if you separate them with commas 
(,). The account designators are: 

[*/*] 

Process all user file directories on the disk 
[P/*] 

Process all user file directories with project number p 
[*,pn] 

Process all user file directories with programmer 
number pn 

[P/Pn] 

Process only the user file directory with project 
number p and programmer number pn 

NOTE 

For disks initialized prior to V8 . , REORDR does not 
order account [1,1], even though it may be implicit in 
an account designation. 



Reordering Your Disks 

To reorder all disks in the public disk structure, you must include 
the device designator for each disk and the account numbers of the 
files you want reordered: 

Device and UFD Speci f ication( s ) ? DB0:[*,*], DBl:[*,*] 
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REORDR orders all the directories in the UFD on RP04 unit and then 
all the directories in the UFD on RP04 unit 1. Make sure you 
logically mount the disks with write access before running the 
program. 

To prevent damage to a directory, REORDR requires that all files in a 
UFD be closed during the entire operation. 

Note 

REORDR verifies that no file is open when it starts 
to process the UFD. However, it is unable to detect 
file opening, creation, or deletion between the 
initial check and the completion of the UFD 
processing. REORDR can damage the file structure of 
a disk if a file creation takes place during 
reordering. For this reason, follow either of these 
steps as a precaution: 

o Disable logins with the SET SYSTEM/NOLOGINS 

command. Make sure that no other jobs (including 
spoolers and detached jobs) are active on the 
system. 

o Dismount the disk to be reordered and remount it 
using the /NOSHARE qualifier. 

The only safe way to reorder a UFD on the public 
structure is to disable logins and to make sure that 
no other user is currently logged in. You should 
reorder a UFD on a private disk only when you are 
sure that no other job will access the account(s) 
being reordered on that disk. If you follow the 
second step, this is no problem. 



Error and Processing Messages 

During the reordering of a UFD, the REORDR program holds the reordered 
UFD in a temporary file. At the conclusion of the ordering process, 
REORDR copies the temporary file back to the original UFD. As REORDR 
processes each UFD, it generates either a message indicating that the 
reorder worked or one that tells why an attempted reorder did not 
work. The messages REORDR prints in the attempt to reorder an account 
are : 

Directory dev:[m,n] cannot be Reordered 
Directory dev:[m,n] does not exist 
Directory dev:[m,n] has been Reordered 

Directory dev:[m,n] is not Reordered - File filename . type is OPEN 
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Directory dev:[m,n] is not Reordered - No write access to UFD 
Directory dev:[m,n] is Null 

|< format >| |< text >| 

The general format and the example of the format contain a device 
designator and an account number: 

Directory dev:[m,n] |< text >| 

Directory DR3: [1,223] has been Reordered 

Table 11-3 explains each message. 
Table 11-3: REORDR Message Text 

+ + 

| REORDR Message and Response | 
+ + 

cannot be Reordered 

Account [0,1] contains open files during timesharing and 
thus REORDR cannot reorder them. 

does not exist 

REORDR cannot find the account on the device. 

has been Reordered 

REORDR has successfully reordered the UFD. 

is not Reordered - File filename. typ is OPEN 

A user is accessing the UFD and thus REORDER leaves the UFD 
intact . 

is not Reordered - No write access to UFD 

REORDER encounters a UFD to which it cannot gain write 
access. It prints the error message and continues. 



is Null 



No UFD exists for the account. If REORDR encounters an 
account without a UFD, it prints the IS NULL error message 



Fatal errors cause REORDR to print a message of the form: 

7REORDR Fatal Error [code] |< message >| AT LINE nnnnnn 
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All fatal REORDR errors include the PREORDR Fatal Error prefix, a 
program error code, a message, and a program line number. Code 
represents the number of the program error that caused the fatal 
condition to occur. (DIGITAL uses the code number to determine the 
reason for the fatal error.) REORDR prints a brief message to help 
identify the error. Finally, the error message includes the line 
number at which the program came to an end. Submit a Software 
Performance Report (SPR) to DIGITAL whenever REORDR encounters a fatal 
error. 



REORDR Example 

The following example shows the REORDR dialogue and the messages that 
result from the reordering process: 

$ RUN AUXL I B$ : REORDR 
REORDR V9.0 RSTS V9 . EDERE 

Sort Directory(s) (YES/NO) <N0>? YES 

Order by CRE [ ATION ] or ACC[ESS) Date<CRE>? CREATION 

In FOR [WARD ] or REV[ ERSE ] Order<FOR>? REVERSE 



Device and UFD 
Directory DB1 : 
Directory DB1: 
Directory DBl: 
Directory DBl: 
Directory DB2 : 
Directory DBl: 
Directory DB2 : 
Directory DB2 : 
Directory DBl: 
Directory DBl: 
Directory DBl: 
Directory DB2 : 
Directory DB2: 
Directory DB2 : 
Directory DB2: 
Directory DBl: 
Directory DB2 : 
Directory DB2 : 
Directory DB2 : 
Directory DB2 : 
Directory DB2: 



Specif ication( s)? DBl: [*,*] ,DB2: [*,*] 
0,1] cannot be Reordered 
1,1] cannot be Reordered 
1,3] has been Reordered 
1,4] has been Reordered 
1,8] has been Reordered 
1,13] has been Reordered 
1,44] is Null 
is Null 
has been Reordered 
has been Reordered 
has been Reordered 
has been Reordered 
has been Reordered 
has been Reordered 
100,100] has been Reordered 
120,50] has been Reordered 
120,54] is Null 
210,203] has been Reordered 
232,15] has been Reordered 
232,13] has been Reordered 
251,0] has been Reordered 



1,77] 
1,200 
1,201 
1,202 
2,227 
2,240 
26,12 



Sort Directory(s) (YES/NO) <NO>? <CTRL/Z> 
$ 
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Caching Control 

Data caching stores blocks from a user file for direct memory access. 
Directory caching stores the Master File Directory (MFD), the Group 
File Directory (GFD), the User File Directory (UFD), monitor overlay 
code, and other frequently accessed system files and directories. 

When a user job executes a read request, the RSTS/E monitor performs a 
disk access and transfers the requested block(s) of data from the disk 
to the user job's buffer. With data (and/or directory) caching, the 
monitor stores the most recently read data blocks in an area of memory 
called the cache. If a user job executes a read request for a data 
(and/or directory) block in the cache, the monitor copies the 
requested data directly from the cache into the job's buffer. Because 
the system can thus retrieve data blocks from memory instead of disk, 
physical disk access is decreased. This can result in improved I/O 
throughput and faster response time. 

Data caching is only useful for read operations. Every write 
operation causes an actual write to the disk. In a write operation 
that modifies existing cached data, the data is updated, both in the 
cache and on the disk. 

You must specify explicitly a choice of caching during system 
installation (see the RSTS/E System Installation and Update Guide). 
You can generate two types of caching: 

o Directory caching only 

o Data and directory caching 

Directory caching is automatically enabled at system start-up. If you 
select data caching, it is automatically enabled provided that at 
least 2K words of XBUF are allocated. 

You can also enable data caching with the DCL command SET CACHE. 
Moreover, DCL commands let you specify caching for a particular file 
because it lets you mark the file's UFD entry. 

Under the BASIC -PLUS or MACRO programming languages, you can use MODE 
values in the OPEN statement or monitor directives to open a file for 
cached data access. However, the use of caching MODE values and 
monitor directives requires TUNE privilege. As system manager, you 
can use the DCL command SET FILE (see Chapter 12) to designate a file 
for caching by marking its UFD entry. Once you mark a file's UFD 
entry for caching, it is cached on OPEN regardless of the user's 
privilege, as long as caching is enabled on the system. See the 
RSTS/E Programming Manual for information on the BASIC-PLUS OPEN 
statement and the RSTS/E System Directives Manual for information 
about MACRO directives. 
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When you select and enable data caching, the cache receives all data 
transfer requests that are otherwise directed to the disk driver. 
Read operations on data that is in the cache occur without placing a 
load on the disk driver. The monitor constantly updates the cache so 
that it contains the most recently requested data for cached files. 



Size of the Cache 

The RSTS/E monitor allocates space for the cache from the Extended 
Buffer Pool (XBUF). You specify the amount of this allocation with 
DCL command qualifiers that set the size of a cache cluster 
(/CLUSTERSIZE=n) and the number of clusters in the cache (/MAXIMUM=n, 
/DIRECTORY_MAXIMUM=n, and /DATA_MAXIMUM=n ) . The size of a cache 
cluster (1, 2, 4, or 8 blocks) determines the amount of data that is 
treated as a unit in a read request and, in many cases, the number of 
read requests that can be resolved in the cache before access to the 
disk driver is required. 

For example, when the cache cluster size is eight blocks, any read 
operation that installs data in the cache causes eight physically 
contiguous blocks (including the requested blocks) to be installed. 
To ensure that only requested data is read in to the cache, make the 
cache cluster size equal to or less than the pack cluster size (set 
during disk initialization) of the disk with the most files to be 
cached . 



Sequential and Random Caching Modes 

You can cache the data in a file in two ways: sequential or random. 
You can specify either of these modes for a particular file with the 
SET FILE command qualifiers (see Chapter 12). 

If a job executes a read operation on a cached file and the data is 
not in the cache, that data is installed in the cache if there is free 
space or if a current cache cluster is eligible for replacement. 

A cluster is eligible for replacement if either of the following 
conditions is in effect: 

o The last block of the cluster has been read in sequential 
mode . 

o The cluster has been in the cache without being read for more 
than the minimum residency time, which is set using the SET 
CACHE command. 

1 
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Random Mode Caching 

DIGITAL recommends caching a file in random mode if the file is RMS 
index structured. With an RMS indexed file structure, the monitor 
does not access the data in the file sequentially but must check the 
file index each time it gets more data. Thus, it reads the index, the 
data, and the index again. 

As an example of random cache operation, consider a read operation 
executed on a file whose UFD entry is marked for random caching. When 
a read on the cached file occurs, the monitor examines the contents of 
the cache to determine if the requested data is present. If the data 
is in the cache, the data is copied from the cache cluster that 
contains it. The data is made available to the program and the cache 
cluster time of last access is updated. 

If the requested data is not in the cache, the monitor first attempts 
to allocate more of XBUF to install the new data (cache limits 
permitting). If XBUF cannot accommodate more data or the request 
exceeds the caching limits set with SET CACHE, then the monitor 
examines the list of cache clusters to find one that is eligible for 
replacement. If a cluster is not available, the monitor cannot 
install the requested data in the cache; a normal disk read is 
automatically performed. If the cache cluster is eligible for 
replacement, the monitor installs the requested data in that cache 
cluster and makes the data available to the program. 



Sequential Mode Caching 

DIGITAL recommends caching a file in sequential mode if you access the 
contents of the file sequentially. As an example of sequential cache 
operation, consider a read operation executed on a file whose UFD 
entry is marked for sequential caching. When a read on the cached 
file occurs, the monitor examines the contents of the cache to 
determine if the requested data is present. If the data is in the 
cache, the data is copied from the cache cluster that contains it. 
The data is made available to the program. If, in the process, the 
last block of a cache cluster was read, that cluster is made available 
for replacement in the cache. 

Furthermore, when you request a read operation on any block of a cache 
cluster (except the last block), the monitor installs. a full cluster 
of data in the cache. That is, if you use the SET CACHE command 
qualifier /CLUSTERSIZE=n to set a cache cluster size of 8 blocks and 
then execute a read on the first block of a file, the requested data 
plus the next 7 blocks from the disk are read into the cache. Thus, 
the contents of the next 7 reads can be satisfied from the cache. 
When the last block of the cache cluster is read, the cluster is 
immediately made available for the installation of new data as 
requested by other read operations. 
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When a read operation from a sequentially cached file causes more than 
one cache cluster to be read, all of the requested data blocks are 
made available to the program. However, no data is installed in the 
cache for any cluster whose last block was read. (That is, only the 
last cluster can be installed and only if it was incompletely read.) 
If the cache cluster size is defined as one block and sequential mode 
is specified, no data blocks are installed in the cache. Thus, every 
data block is the last block in a cache cluster. 



Caching Guidelines 

The relationship between cache cluster size, which you set with a SET 
CACHE/CLUSTERSIZE=n command, and the pack cluster size of the file can 
have an effect on the efficiency of caching. The cache cluster size 
determines the number of blocks on a disk copied into the cache when a 
cluster is installed. If the cache and pack cluster sizes are equal, 
there is direct correspondence between the data that will probably be 
read and the data copied from the disk to the cache. If the cache 
cluster size is larger than the pack cluster size, the data you 
request plus some additional (and possibly unrelated) data is copied 
to the cache, wasting cache clusters. If the cache cluster size is 
less than the pack cluster size, a read request may require multiple 
disk accesses to move all of the data into several different cache 
clusters . 

Figure 11-1 shows the flow of UFD entry and MODE value checks 
performed by the monitor. The result of these checks determines the 
type of caching to be used on the file. 
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Figure 11-1: Caching Mode Checks 



The size relationship between the cache cluster and RMS indexed file 
bucket is similar to the size relationship between the cache cluster 
and the pack cluster. Efficient caching is obtained when the cache 
cluster and bucket sizes are equal because RMS always reads an entire 
bucket at once. 

Consider the following caching guidelines: 

o When setting defaults, the amount of XBUF you allocate to 
data and directory caching should be as large as possible 
while maintaining sufficient memory for user jobs, resident 
libraries, and run-time systems. However, an exceptionally 
large allocation can increase swapping activity, especially 
on systems with less than 128K words of memory. 

o On systems that use RMS heavily, consider the use of the RMS 
resident library and the library's effect on XBUF allocation. 
Typically, on systems with less than 128K words of memory, 
the resident library should receive priority in memory 
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allocation, to the extent of limiting XBUF allocation. In 
such a case, data caching may become ineffective and you 
probably should disable it. 

o To optimize directory caching, set all UFD cluster sizes to 
16 blocks if possible. 

o Files that are frequently accessed sequentially (including 
RMS sequential and relative files) should have their UFD 
entries marked for sequential caching with the DCL command 
SET FILE/CACHE=SEQUENTIAL. 

o Files that are frequently accessed randomly (including RMS 
relative and indexed files) should have their UFD entries 
marked for random caching with the DCL command SET 
FILE/CACHE=RANDOM. Because of the way RSTS/E maintains RMS 
indexed files, they should always be flagged as random even 
if they are accessed sequentially. Where possible, RMS 
indexed file bucket sizes should be a power of two to 
correspond with caching cluster sizes. 

o Use data caching judiciously on RMS indexed files. You gain 
the most benefit from caching an indexed file when it is 
subject to many read requests and is open for long periods of 
time. In addition, you should allocate more XBUF to 
compensate for the lower caching "hit" rate (the probability 
that the data you want to read is in the cache) on indexed 
file data. The hit rate is generally lower on indexed files 
than it is on sequential files or directory blocks. 

o Where possible, all files should be contiguous to reduce 
window turning. 

Where contiguous files are not possible, you should calculate 
the file cluster size as follows: 

1. Divide the file size by seven 

2. Round the result to the next higher power of two (not 
greater than 256 nor less than the pack cluster size) 



Note 

If you preextend the file, RSTS/E does this 
calculation for you. 



o The minimum residency time is meant to keep some useful data 
in the cache, even when the cache is very small. Minimum 
residency time is also meant to make sure that if you want to 
access previously accessed data the system will find it in 
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the cache, rather than having to read information off disk 
each time you request more. For systems with large caches or 
rapidly changing disk access patterns, it may be advantageous 
to reduce the minimum residency time from its default value 
of 60 seconds. Use the /KEEP=n qualifier to modify minimum 
residency time. 

Caching is not the most efficient data access method for all files 
under all circumstances. But, in general, a high-access file is a 
logical candidate for caching. A high-access file meets one or more 
of the following conditions: 



o Accessed by more than one user at a time 



o Opened for long periods of time 

o Frequently accessed 

o Accessed sequentially (indexed files) 

o Primarily read 



o Is an overlaid program (such as a user program, TKB, or DTR) 



However, because of the large number of different applications, you 
must experiment to arrive at the best use of caching on your system. 



DCL Command Descriptions 

The following sections describe the DCL commands and qualifiers for 
Device Management and Caching Control. 
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ALLOCATE Command 

The ALLOCATE command allocates a device and optionally assigns it a 
logical name. ALLOCATE does not require any privileges to allocate a 
device to your own job. 



+ 

Format 

ALLOCATE dev : [ logi cal_name [ : ] ] 

Command Qualifiers 

/JOB=n 
/SEIZE 

Prompts 

i 
I 

| None 

+ 



- + 



Defaults 



+ 



Command Parameters 
dev : 

Specifies the device to be allocated, 
logical^ name [ : ] 

Specifies the logical name to be assigned to the device. 
Command Qualifiers 
/JOB=n 

Allocates the device to the specified job. You need HWCTL 
privilege to use this qualifier. 



/SEIZE 



Reallocates a device currently allocated to another job. The 
/SEIZE switch returns an error message if a file is open on the 
device. You need HWCTL privilege to use this qualifier. 
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DEALLOCATE Command 

The DEALLOCATE command deallocates the specified device. DEALLOCATE 
does not require any privileges. 



Format 

DEALLOCATE dev[ : ] 

Command Qualifiers 

/ALL 

Prompts 

None 



Defaults 



Command Parameters 
dev: 

Specifies the device to be deallocated. 
Command Qualifiers 
/ALL 

Deallocates all devices that were allocated to the current job. 
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SET CACHE Command 

The SET CACHE command and qualifiers let you set caching parameters 
for the system as a whole. The SET CACHE command lets you enable data 
and directory caching on the system. Note that commands in the system 
start-up command file normally enable caching automatically. You need 
TUNE privilege to use the SET CACHE command. 

When you use SET CACHE with no qualifiers, the last settings specified 
are applied. The initial system defaults are: 

/CLUSTERSIZE 4 blocks 

/MAXIMUM No limit on total cache allocation 

/DIRECTORY_MAXIMUM No limit on directory caching 
/DATA__MAX I MUM No limit on data caching 

/KEEP 60 seconds 

If you use SET CACHE/ALL, all read requests are cached. The type of 
caching (sequential or random) for a particular file is determined by 
the file's UFD entry as specified in the SET FILE command or by an 
OPEN MODE specification. 

If you use SET CACHE/FILE, a file is cached on the basis of its UFD 
entry and/or the specified OPEN MODE. That is, a file is cached if 
either the UFD entry or OPEN MODE specifies caching; it is cached 
sequentially if either the UFD entry or OPEN MODE specifies 
sequential . 

If you use SET CACHE/NOFILE, RSTS/E does not cache files. This 
qualifier is used to enable directory caching but disable data caching 
on the system. 

Figure 11-2 shows the mechanism by which the monitor decides the 
amount of caching to be performed. The figure shows the flow of DCL 
commands and caching specifications examined by the monitor. 
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Yes 



Yes 




H-MK-00076-00 



Figure 11-2: Monitor Caching Checks 



The /BUFFERS and /NOBUFFERS qualifiers specify the use of general 
small buffers for directory caching. These qualifiers are meaningful 
only if you did not select data caching at system installation time. 
If you specify a SET CACHE/BUFFERS command on a system that has data 
caching installed, the monitor prints the following error message: 



?Missing special feature 



If data caching is installed, you can not use small buffers for 
caching. 



Use the SET CACHE/CLUSTERSIZE=n command to specify the cache cluster 
size as 1, 2, 4, or 8 blocks for each cluster. The cache cluster size 
controls the number of contiguous data blocks that are copied from 
disk to the cache whenever file data is cached. The cache cluster 
size should be small enough to contain only the target blocks but 
large enough to reduce the number of disk accesses. This means you 
must anticipate data requests and ensure that the cache cluster size 
is equal to the file cluster size of the files most frequently 
accessed . 
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The SET CACHE/MAX I MUM =n command (where n is in the range to 
UNLIMITED) specifies the total number of cache clusters used by both 
directory and data caching. The default limit is UNLIMITED, which 
means that cache cluster allocation is limited only by the amount of 
XBUF available. 

The SET CACHE/DIRECTORY_MAXIMUM=n and SET CACHE/DATA_MAXIMUM=n 
commands (where n is in the range to UNLIMITED) specify the cache 
cluster allocation for directory and data caching, respectively. The 
specified allocation is an upper limit. Thus, if a 40K-word XBUF is 
defined at system installation and /D I RECTOR Y_MAX I MUM and 
/DATA__MAX I MUM both specify a number of cache clusters equivalent to 
25K, data can use space in the cache up to a maximum of 25K, which 
leaves a 15K minimum for directory caching. The reverse is also true. 
In this manner, data and directory caching are guaranteed a minimum 
allocation and the amount of overlap is controlled, which permits the 
cache to dynamically adjust to system and program requirements. 

The SET CACHE/KEEP=n command specifies the cache replacement time in 
seconds. This is the amount of time that RSTS/E keeps an unused cache 
cluster in memory before the monitor replaces it with another cache 
cluster . 

The SET CACHE/DISABLE command disables all data and directory caching 
on the system. If you reenable caching following a disable and do not 
specify caching parameters (/CLUSTERSIZE, /MAXIMUM, 

/D I RE C TOR Y_MAX I MUM , /DATA__MAX I MUM , and /KEEP), the default parameters 
are those that were in effect before the disable. 

+ + 

| Format | 

| SET CACHE I 

| Command Qualifiers Defaults | 



/ALL 

/[NO] BUFFERS 

/CLUSTERSIZE=n 

/DATA_MAX I MUM=n 

/DIRECTORY__MAXIMUM=n 

/DISABLE 

/ENABLE 

/[NO ] FILE 

/KEEP=n 

/MAX I MUM =n 



/BUFFERS 
/CLUSTERSIZE=4 



/ENABLE 
/ENABLE 
/FILE 



Prompts 



None 



+ 



+ 
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Command Qualifiers 
/ALL 

Caches all data transfers. 
/[NO ] BUFFERS 

Indicates whether general small buffers are used for directory 
caching. The default is /BUFFERS. 

/CLUSTERSIZE=n 

Specifies a cache cluster size of n with values equal to 1, 2, 4, 
or 8 blocks. The default is /CLUSTERSIZE=4 . 

/DATA_MAX I MUM= n 

Specifies the maximum number of clusters (based on available 
memory) used for data caching in the range to UNLIMITED. 

/DIRECTORY_MAXIMUM=n 

Specifies the maximum number of cache clusters used for directory 
caching in the range to UNLIMITED. 

/DISABLE 

Disables data and directory caching. 
/ENABLE 

Enables caching on the system using the previous settings as the 
defaults. The default is /ENABLE. 

/[ NO ] FILE 

Indicates if file data should be cached. The /FILE qualifier 
indicates that file data is cached depending on their file 
attributes or OPEN MODE. The /NOFILE qualifier indicates that no 
file data is cached. The default is /FILE. 

/KEEP=n 

Specifies the cache replacement time in seconds that an unused 
cache cluster is kept in memory before the space can be used for 
another cache cluster. 

/MAX I MUM =n 

Specifies the maximum number of cache clusters used for directory 
and data caching in the range to UNLIMITED. 
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SET DEVICE Command 

The SET DEVICE command sets the characteristics for the specified 
device. SET DEVICE does not require any privileges. 



+ - - - - 



- - + 



Format 

SET DEVICE dev: 

Command Qualifiers 

/DISABLE 
/ENABLE 
/[NO] RESTRICT 

Prompts 

Device: 



Defaults 



+ 



Command Parameters 
dev: 

Specifies the device whose characteristics you want to change. 
Command Qualifiers 
/DISABLE 

Disables the specified device. No other qualifiers can be 
specified with /DISABLE. 

/ENABLE 

Enables a device that has been disabled by the SET DEVICE/DISABLE 
command . 



/[NO] RESTRICT 

Tells the system which users can open or allocate the specified 
device. The /RESTRICT qualifier lets only users with DEVICE 
privilege open or allocate the device. The /NORESTRICT qualifier 
lets any user open or allocate the device. 
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SET PRINTER Command 

The SET PRINTER command sets the characteristics of the specified line 
printer. You need HWCFG privilege to use the SET PRINTER command. 



Defaults 
/BACKS PACE=REAL 



Format 

SET PRINTER dev[ : ] 

Command Qualifiers 

/BACKSPACE [ =mode ] 
/[NO] CONTROLS 
/[NO]CR_PREFIX 
/DEVI CE__TYPE=type 
/ [ NO ] E I GHT_B I T 
/[NO]EOT 
/[NO] FILL 
/LOWERCASE 
/[NO]OMIT_CR 
/PAGE_LENGTH=n 

/[ NO ] SPECIAL_CHARACTER[ =char ] 
/[NO] TAB 
/UPPERCASE 
/WIDTH 

Prompts 

Printer : 

+ + 

Command Parameters 
dev[ : ] 

Specifies the line printer whose characteristics you want to set. 

Command Qualifiers 

/BACKSPACE [ =mode ] 

Tells the system how to handle backspace characters for this 
printer. The possible modes are: 

o CONTROL -- Treats a backspace like other nonprinting 
characters . 

o REAL -- Uses the actual backspace feature on the specified 
printer . 
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o SIMULATE -- Simulates the action of backspace on the 

specified printer by issuing a carriage return (CR) followed 
by the appropriate number of spaces to position the print 
head one column to the left of its original position. 

The default is /BACKSPACE=REAL . 

/[NO] CONTROLS 

Tells the system how to handle nonprinting characters. /CONTROLS 
sends nonprinting characters to the line printer. /NOCONTROLS 
discards nonprinting characters or uses up arrow mode. 

/[NO]CRJPREFIX 

Tells the system how to handle line feed (LF), vertical tab (VT), 
and form feed (FF) characters. The options are: 

o /CR_PREFIX inserts a CR before a LF, a VT, or a FF. 

o /NOCR__PREFIX tells the printer to do an implied CR before a 
LF, a VT, or a FF. 

/DEVI CE_TYPE= type 

Sets the characteristics of the line printer to the specified 
type : 

o LA180 -- Sets the characteristics of the line printer to 
those of an LA180. 

o LN01 Sets the characteristics of the line printer to those 
of an LN01. 

o LPll -- Sets the characteristics of the line printer to those 
of an LPll. 



/[NO ] EIGHT_BIT 

Tells the system how to handle 8 -bit characters. The /EIGHTJ3IT 
qualifier lets you send 8-bit characters to the line printer. 
The /NOEIGHT_BIT qualifier does not let you send 8 -bit characters 
to the line printer. 

/[NO] EOT 

Tells the system how to handle an end-of -transmission character. 
The /EOT qualifier sends an end-of -transmission (CTRL/D) to the 
line printer. The /NOEOT qualifier treats an end-of -transmission 
(CTRL/D) like other nonprinting characters. 



11-24 



SET PRINTER 



/[ NO ] FILL 

Tells the system how to handle fill characters. The /FILL 

qualifier inserts fill characters after form feeds. The /NOFILL 

qualifier does not insert fill characters after form feeds. 

/LOWERCASE 

Sends lowercase characters to the line printer. 
/[NO]OMIT_CR 

Instructs the system on how you want the CR character handled. 
The /OMIT__CR qualifier tells the system to omit the CR if the 
next character is a LF. The /NOOMIT__CR qualifier tells the 
system to always send CR to the printer. 

/PAGE_LENGTH=n 

Sets the form length of the line printer to n. The form length 
can be in the range 1 to 255. 

/[ NO ] SPECIAL_CHARACTER[ =char ] 

Instructs the system on how you want the printer to handle its 
special character. The /SPECIAL_CHARACTER=char qualifier tells 
the printer to print its special character whenever it receives 
the specified char. Char can be given by its numeric value in 
the range to 255 or by enclosing the character in quotation 
marks ( " ) if it is printable. The /NOSPECIAL_CHARACTER qualifier 
tells the system to disable the special character feature for the 
specified line printer. 

/[NO ] TAB 

Instructs the system on how you want the TAB character handled. 
The /TAB qualifier indicates that the printer has hardware TAB 
capability. The /NOTAB qualifier indicates that the printer does 
not have hardware TAB capability and the system has to translate 
TAB characters to the appropriate number of spaces. 

/UPPERCASE 

Tells the system to convert lowercase characters to uppercase 
before sending them to the line printer. 

/WIDTH=n 

Sets the width of the line printer to n. The width can be in the 
range to 254. 
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SHOW CACHE Command 



The SHOW CACHE command displays the current caching parameters for 
your system. SHOW DEVICE does not require any privileges. 

The listing includes information on cluster sizes, data caching, and 
whether general small buffers are used. For example: 



$ SHOW CACHE 

Caching enabled for Directories and Data 

Cache Keep timer = 60 seconds 

Cluster size = 4 

Data caching = File selectable 



Cluster 
Maximums 
Usage 
K Words 



All 

Unlimited 
224 
224.00 



Di rectory 
Unlimi ted 
209 
209.00 



Data 
Unlimited 
15 
15.00 



K Words of Buffer usage for: 

System DCL Quotas in Quotas in 

Logicals Buffers XBUF Small Buffers Overlays 

0.56 0.00 0.44 4.19 



$ 



In this example, SHOW CACHE reports that: 



o Directory and data caching were installed on the system 
during system installation, and caching was enabled 

o The current cache cluster size is 4 blocks, only selected 
files are cached, and general small buffers are not used 

o No limit is set on the use of XBUF for the cache 

o The cache keep timer is set to 60 seconds 

o 209 K words are in use for directory caching 

o 15 K words are in use for data caching 
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Format 

SHOW CACHE 

Command Qualifiers 

None 

Prompts 

None 



Defaults 



+ 



The SHOW CACHE command has no qualifiers or prompts 



11-27 



SHOW DEVICE 



SHOW DEVICE Command 

The SHOW DEVICE command displays information about the specified 
device. If you do not specify a device, RSTS/E displays information 
about all devices. SHOW DEVICE does not require any privileges. 



+ - - 



- — + 



Format 

SHOW DEVICE [dev[ : ] ] 
Command Qualifiers 
/ALL 

/ALLOCATED 



Defaults 
/ALL 



Prompts 
None 

+ + 

Command Parameters 
dev[ : ] 

Specifies the device whose characteristics you want to display. 
Command Qualifiers 
/ALL 

Displays information about all devices configured on the system 
A device specification overrides the /ALL qualifier. 

/ALLOCATED 

Displays information about all devices that are currently open 
allocated. The display includes devices that are open as 
non- file - structured devices. 
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SHOW DISKS Command 



The SHOW DISKS command displays the status of all mounted disks 
DISKS does not require any privileges. 



SHOW 



Format 

SHOW DISKS 

Command Qualifiers 

None 

Prompts 

None 



Defaults 



The SHOW DISKS command has no qualifiers or prompts 



11-29 



SHOW PRINTER 



SHOW PRINTER Command 

') 

The SHOW PRINTER command displays the characteristics of the specified 
printer. SHOW PRINTER does not require any privileges. 



Format 

SHOW PRINTER dev[ : ] 

Command Qualifiers Defaults 
/ALL /ALL 
Prompts 

None 

+ + 

Command Parameters 
dev : 

Specifies the printer whose characteristics you want to display. 
Command Qualifiers 
/ALL 

Displays information about all the printers configured on the 
system. A printer specification overrides the /ALL qualifier. 
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Managing System Files and Logical Names 



This chapter describes the DCL commands that you use to manage RSTS/E 
system files and logical names. Table 12-1 lists and briefly 
describes the DCL commands available to you. The rest of the chapter 
lists each command alphabetically and explains it in more detail. 



Table 12-1: DCL Commands for Managing System Files and Logical Names 



Command 


| Meaning 


Run-Time System Control 


INSTALL/RUNTIME_SYSTEM 


Adds the named run- time system to the 
| list of installed run-time systems. 


REMOVE/RUNT I ME__SYSTEM 


| Removes the name of a run- time system 

| module as an entry in the run-time system 

| table. 


SHOW RUNTIME_SYSTEM 


| Displays information about all installed 
| run-time system. 


UNLOAD/RUNT I ME__SYSTEM 


| Unloads the named run-time system from 
| memory. 


Resident Library Control 


INSTALL/LIBRARY 


| Adds the named library to the list of 
| installed resident libraries. 


REMOVE/LIBRARY 


| Removes the named file as a resident 
| library. 
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Table 12-1: DCL Commands for Managing System Files and Logical Names 
(Cont. ) 



Command 



Meaning 



Resident Library Control (Cont.) 

+ 



SHOW LIBRARY 



Displays information about all installed 
libraries . 



UNLOAD/LIBRARY 



Removes the named resident library from 
memory. 



- - - - + 

System Logical Names Control 

- - - - + 



ASSIGN/SYSTEM 



DEAS SIGN/SYSTEM 



SHOW LOGICAL/SYSTEM 



Assigns a system-wide logical name to the 
specified device type and unit. If you 
include an account number, the 
ASSIGN/SYSTEM command also associates 
that PPN with the logical name. 



Removes the enti 
name from the sy 
can also remove 
on your system, 
system devices h 
the logical tabl 
DEAS SIGN/SYSTEM 
logical name ass 
only the logical 
device mnemonic, 
new name to that 



re entry for the logical 
stem logical table. It 
logical names for devices 
Device mnemonic names for 
ave permanent entries in 
e. If you use the 
command to remove a 
ociated with a device, 
name goes away, not the 
You can then assign a 
device . 



Displays information about a system-wide 
logical name. 



+ 

Systemi-wide Command Language Control 

+ 



DEFINE/COMMAND/SYSTEM 



DELETE/COMMAND/SYSTEM 



SHOW COMMAND/SYSTEM 



Creates or redefines a system-wide 
command . 

Deletes the specified command from the 
list of defined system-wide commands. 

Displays information about the specified 
system-wide command. 
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Table 12-1: DCL Commands 
(Cont . ) 



for Managing System Files and Logical Names 



Command 


+ 

| Meaning 


System File Control 


DUMP/SYSTEM 


| Records in the CRASH. SYS file the current 
| state of the system so you or field 
| service has a way to investigate reasons 
for system malfunctions. 



INSTALL/ERROR_FILE 

INSTALL/OVERLAY_FILE 

INSTALL/SWAP_FILE=n 

REMOVE/ERROR_FILE 
REMOVE/OVERLAY_F I LE 
REMOVE/SWAP_FILE=n 

SHOW FILE 



Installs the specified file as the system 
error message file. 

Installs the specified file as the system 
overlay file. 

Adds the specified file to the list of 
installed swap files. Valid values of 
swap-index are 0, 1, or 3. 

Removes the system error message file. 

Removes the system overlay file. 

Removes the specified swap file from the 
list of installed swap files. Valid 
values of swap-index are 0, 1, or 3. 

Displays information about the specified 
f ile( s) . 



User File Control 



+ 



| SET FILE 

I 

i SHOW LOGICALS 

I 

+ 



Sets the file characteristics. 

Displays information about a user-defined 
logical name. 



Run-Time System Control 

A run-time system on RSTS/E is the common, shareable part of a user 
job and, in some cases (for example, BASIC-PLUS), is the interface 
between the user's executable code and the monitor. Run-time systems 
control execution of jobs when the monitor allows the jobs to run. 
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The monitor sets up jobs and establishes an environment in which a 
run-time system can function. The BASIC-PLUS run-time system 
interprets requests made by a user job, translates those requests into 
a format the monitor understands, and transmits the requests of the 
monitor. The monitor processes the requests and passes either data or 
an error to the job. The run-time system decides whether to interpret 
the data or log an error. Jobs running under the BASIC-PLUS run-time 
system cannot make direct requests to the monitor. 

Other run-time systems may not be language interfaces in the same 
sense that the BASIC-PLUS run-time system is. Jobs under their 
control can make direct requests of the monitor. In such cases, the 
major role of the run-time system is to load compiled programs to 
handle system errors, and return control, on program termination, to 
the job's keyboard monitor. Some of these run-time systems can also 
emulate the action of certain system directives from other operating 
systems, such as RTll. 

A run-time system interprets user requests when it is a language 
interface for a user job. A computer language provides a standard 
means by which many users can define data, process it, and obtain 
results. The language relieves each user of the need to learn the 
workings of the monitor. The run-time system under which the language 
operates is more efficient because multiple users can share the same 
code. This ability to share code is more efficient for the system 
because each user need not have a copy of the common code. 

All RSTS/E installations have a primary run-time system and can 
optionally have auxiliary run-time systems. The primary run-time 
system: 

o Allows users access to system resources 

o Interprets system command requests 

o Performs housekeeping chores 

An auxiliary run-time system: 

o Provides additional shared computer processing functions 

o Enables processing in other languages 

Such an auxiliary run-time system may compile and/or execute 

BASIC -PLUS-2, COBOL, DIBOL, FORTRAN- IV, FORTRAN- 77, or other language 

operations. 

The system account [0,1] stores run-time systems as contiguous files 
with . RTS file types. You must store the primary run-time system 
(RSX.RTS) and DCL on the system disk because, at the start of 
timesharing, the system disk is the only disk mounted on the system. 
You can store auxiliary run-time systems on any disk, either public or 
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private. (Auxiliary run-time system files can also be stored in 
accounts other than [0,1].) All run-time system files are contiguous 
because they must be loaded into memory in the fastest time possible. 

The primary run-time system must be either DCL or RSX. Some 
considerations that may help you decide which one to install as your 
primary run-time system are: 

o RSX requires IK of reserved memory; DCL requires 28K 

o If you have sufficient memory and do not need the RSX 

keyboard monitor, install DCL as your primary runtime system. 
Then, you can choose to not install the RSX run-time system. 

o If you have 124K or less of memory, use RSX as your primary 
run-time system. You still need DCL; however, the system can 
swap DCL out when it is not in use by other jobs on the 
system. 

Auxiliary run-time systems are created either during system 
installation or afterwards. The monitor structures that describe 
these run-time systems do not exist automatically at the start of 
timesharing. Therefore, you must provide the commands to add monitor 
structures for the auxiliary run-time systems that you want to make 
available for any given time-sharing session. The structure for an 
auxiliary run-time system is dynamic and can be removed during a 
time-sharing session. 

The DCL run-time system commands let you control operations of 
auxiliary run-time systems. The DCL commands perform additional 
processing for certain commands. To assist the system programmer, the 
command descriptions distinguish between the monitor call action and 
the DCL command action. Because run- time systems under development 
need certain special controls, some features of run-time system 
control are intended for DIGITAL personnel only. Nevertheless, all 
features are described to give you a broader perspective. 

DIGITAL recommends that you make auxiliary run-time systems available 
by commands in the START.COM file. By reading the descriptions in 
this section, you can understand what actions should occur for each 
run -time system command. 



Adding and Removing Auxiliary Run-Time Systems 

Because the structures that define auxiliary run-time systems are 
temporary, you must create them for each time-sharing session. The 
INS TALL/RUNT I ME__SYSTEM command creates the necessary structure to 
enable an auxiliary run-time system to function. 
INS TALL/RUNT I ME_SYSTEM command qualifiers can alter predefined 
characteristics of the run-time system. 
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The INSTALL/RUNTIME_SYSTEM command creates a run -time system 
description block with a general small buffer. A file with the name 
of the run-time system and a file type of . RTS can be in any account 
on the disk specified in the command. A run-time system with the same 
name cannot already exist on the system. The system makes sure that 
the file found is contiguous and has the proper format and parameters. 

You can specify qualifiers to override predefined characteristics. 
The INS TALL/RUNT I ME_SYSTEM command extracts information from the 
run-time system file to establish the proper entries in the run-time 
system description block. To establish the entries, the monitor opens 
the file, reads it, and sets up the predefined characteristics to be 
placed in the description block. You can change the predefined 
characteristics by the qualifiers: /PREFIX=n, /[ NO ] UNLOAD , 
/ [ NO ] ERROR_LOGGING , /[ NO ] SHAREABLE , /[ NO ] READ__ONLY , and 
/[NO ] KEYBOARD_MONI TOR . 

You can also change the predefined characteristics by negating these 
qualifiers. For example, if you were testing a run-time system with 
no special command decoding capabilities, you would use the qualifiers 
/NOSHAREABLE, /NOREADJDNL Y , /NOERROR_LOGGING , and /UNLOAD to add the 
run-time system. The /NOSHAREABLE makes sure that no other job tries 
to share the untested code; /NOREAD__ONLY is necessary for setting 
breakpoints with ODT; /NOERROR_LOGGING prevents false errors generated 
by the run-time system from cluttering the system error log; /UNLOAD 
makes sure that the run-time system's image is not left in memory but 
is reloaded from disk immediately preceding every entry to it. 

The qualifiers and negations of the qualifiers do not alter the 
predefined characteristics in the run-time system file; only the 
characteristics defined in the description block are altered. The 
characteristics remain in effect until you remove the run-time system. 

The /[NO] ADDRESS [=n] qualifier lets you take advantage of high speed 
memory on the system or avoid fragmentation of memory. Without the 
/ADDRESS=n qualifier, the monitor decides where to load the run-time 
system each time residency is required. With the qualifier, the 
monitor loads the run-time system at the specific lK-word section of 
memory. You must include the /ADDRESS=n qualifier whenever you use 
the /NOREAD_ONLY qualifier. 

The /ADDRESS qualifier without an argument indicates that the monitor 
should compute a starting address by finding the highest memory 
segment large enough to hold the run-time system. 

The /NOADDRESS qualifier lets the run- time system "float" in memory; 
that is, RSTS/E computes a new address every time the run-time system 
is loaded into memory. The default is /NOADDRESS. 

Because lK-word section numbering begins at and ends at n-1 (where n 
is the total size of memory), the IK section number in the /ADDRESS=n 
qualifier is one less than the physical section number. For example, 
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to load the RTll run-time system (4K words in size) into the 61st 
through 64th IK sections of memory, specify /ADDRESS=60. The run- time 
system is loaded from low memory to high memory at its defined 
initialized size. To be loaded without error, enough contiguous user 
space must be available starting at that location. 

The location specified in the /ADDRESS=n qualifier becomes the default 
location at which the run-time system is loaded during the current 
time-sharing session. You need to change the location only if you 
exchange the allocation of the section of memory with either the 
DEFAULT or the START initialization options. 

One precaution is necessary when specifying the address at which the 
run-time system is loaded. The section of memory you choose must not 
fragment the user job space to prevent the run-time system from 
executing a job. For example, assume a system has 24K words of user 
space available between the 36K and 60K sections of memory. Assume 
also that a job requires 18K words of user space to run and that the 
run-time system requires 4K words when resident. If the loading 
address is 36K, the space between 40K and 60K remains available for an 
18K job to run. If the loading address is 42K, the user space is 
fragmented into two sections -- one from 36K to 42K and one from 46K 
to 60K. An 18K-word job area is not available to execute a job using 
this auxiliary run-time system. 

The system verifies that the memory section given in the /ADDRESS=n 
qualifier is reasonable. If the entire range of memory starting at 
the load address is not available, the system prints: 

?Memory not available 

You should consult a memory status report (for example, the report you 
get with the SHOW MEMORY command) to select an available range of 
memory. If the range of memory results in fragmenting that may cause 
a swapping violation, the system prints the error message: 

?Memory would be fragmented 

A swapping violation occurs if the memory to be occupied by the 
run-time system does not allow enough contiguous space for a maximum 
sized job to run. 

Appendix D contains a summary of the errors that can occur when you 
are installing a run-time system. 

The /POSITION=n qualifier indicates the position in the linked list of 
blocks in which the run-time system block is to be placed. The 
primary run-time system block is always first in the list. If the 
run-time system you are adding is to be accessed frequently, you can 
reduce system overhead by placing it in the right position in the 
list. Without the qualifier, the system adds the block to the end of 
the list. 
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If n in the /POSITI0N=n qualifier is one, the block is placed 
immediately after that of the primary run-time system. If n is zero 
or a value greater than the number of currently defined run-time 
systems, the block is added to the end of the list. The default is 
/POSITION=0 . 

The position of a run-time system description block in the linked list 
affects how the system treats a RUN request for a file without a file 
type. On receiving such a RUN request, the system checks the 
indicated directory for all files with the specified name and an 
executable file type. 

For example, if the directory contained three files of the same name 
with file types .BAC, . TSK , and .SAV, the system checks for the 
run-time system nearest the primary run-time system in the linked list 
of description blocks. If RSX was the primary run-time system (whose 
block is always at the root), the system runs the .TSK version of the 
file. 

The /TYPE=f iletype qualifier on the INS TALL/RUNT I ME__SYSTEM command 
changes the default file type used for an executable file. If you do 
not specify this qualifier, the monitor extracts the file type defined 
in the run-time system file. The system applies this default file 
type when a user types a RUN command for a program and does not 
specify a file type. 

The /MINIMUM=s and /MAXIMUM=s qualifiers alter the minimum and maximum 
job sizes (in K words) defined in the file for the run-time system. 
Generally, the minimum value allowed is one and the maximum is 32, but 
a given run-time system may not allow this full range of job sizes. 
For BASIC-PLUS, the minimum and maximum sizes are 2 and 16, 
respectively. 

The /LOCK qualifier makes the run-time system permanently resident. 
Usually, an auxiliary run-time system is temporarily resident. It 
occupies memory as long as the currently active job is running under 
its control. The system frees the memory it occupies when that memory 
is needed to load another run-time system or to load a job running 
under another run-time system. (Thus, the run-time system may be 
nonresident if there are active jobs using it.) The system 
automatically loads the run-time system when a user needs it. If you 
specify the /LOCK qualifier, the auxiliary run-time system becomes 
permanently resident, as the primary run-time system is. The only way 
to make such a run-time system nonresident is to use the DCL command 
UNLOAD/RUNTIME__SYSYTEM . 

The REMOVE/RUNT I ME_SYSTEM command reverses the steps the 
INS TALL/RUNT I ME__SYSTEM command performs. Before you can shut down the 
system, you must remove all auxiliary run- time systems. The SHUTUP 
program performs this removal operation automatically. The system 
checks to make sure that no jobs are currently running under control 
of the run-time system to be removed. If the usage count is zero, the 
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description block is removed from the list and the run-time system 
file is closed. 

The UNLOAD/RUNT I ME_SYSTEM command frees the memory occupied by the 
run-time system. If a job is currently resident or being loaded and 
intends to use the run-time system, the system prints: 

?Run-time system in use 



Associating a File with a Run-Time System 

The SET FILE/RUNTIME_SYSTEM=name command changes the name of the 
run-time system associated with a file. Every disk file on RSTS/E has 
in its directory the name of the run-time system under which it was 
created, except for files that are larger than 65,535 blocks. On a 
RUN request for the file, RSTS/E checks the name to find out what 
run-time system to use for the job. RSTS/E automatically passes 
control to that run-time system which, in turn, executes the file. 

To change the name, RSTS/E attempts to open the file to establish 
write access. If write access is denied, it prints: 

?Protection violation 

The name of the run-time system is written in the directory of the 
file specified. RSTS/E performs this naming operation during the 
system library build procedures when a file designed to run under an 
auxiliary run-time system is transferred from the distribution medium 
using PIP. 



Resident Library Control 

A resident library is a collection of shareable routines or data that 
the task builder links together into a task image file on disk. The 
MAKSIL program formats this disk file into Save Image Library (SIL) 
format. You can store resident libraries on any disk, either public 
or private. (Resident library files can be stored in accounts other 
than [0,1].) All resident library files are contiguous because they 
must be loaded into memory in the fastest time possible. See the 
RSTS/E Programmer's Utilities Manual for more information on resident 
libraries . 

You then use the INSTALL/LIBRARY command to assign the task image 
portion of the SIL file to a contiguous region of physical memory. 
Note that you can also use monitor SYS call -18 to assign the task 
image portion of the SIL file to memory. Once the body of shareable 
routines or data is linked, formatted, and assigned to memory, it 
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becomes a resident library that is accessible to user tasks as part of 
their virtual address space. 



Resident Library DCL Commands 

You can use the DCL commands to install, remove, load, or unload a 
resident library. To distinguish between resident library operations 
and run- time system operations that use the same command names, DCL 
requires the keyword LIBRARY in its syntax for library operations. 
You include the keyword LIBRARY in the DCL command line between the 
operation keyword and the target resident library name. 

For example, the DCL command to add a resident library is: 

INSTALL/LIBRARY [/qual if iers ] name 

The name you include in the INSTALL/LIBRARY command identifies the 
resident library. To identify it in more detail, you can specify a 
device, a PPN and a protection code in addition to the library name. 
If you do not specify these variables, the device defaults to SY: , the 
PPN becomes account [0,1], and the library's protection code defaults 
to <42>. You can also attach qualifiers to the INSTALL/LIBRARY 
command . 

The /[NO] ADDRESS [=n] qualifier locates the resident library at a 
specific point in memory. The n variable can be any number from the 
lowest to the highest available memory locations in increments of 
lK-word sections. The /ADDRESS qualifier without an argument 
indicates that the monitor should compute a starting address by 
finding the highest memory segment large enough to hold the library. 

The /NOADDRESS qualifier lets the library "float" in memory; that is, 
RSTS/E computes a new address every time it loads the library into 
memory. However, this method of loading has the following 
restrictions : 

o A program can only map one such library at any time 

o The program must be running under the RSX emulation run- time 
system 

o The maximum size of the library is 28K words 

o The highest start address for mapping the library is 32K 

The /LOCK qualifier lets you make a resident library permanently 
resident. Usually, a resident library remains in memory only 
temporarily; that is, it occupies memory only as long as currently 
active jobs run under its control. However, when you need to access 
the library again, the system automatically reloads it. To force the 
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library to remain permanently in memory, you must specify the /LOCK 
qualifier in the INSTALL/LIBRARY command. 

If you want to remove a resident library from memory, delete the 
monitor structure that defines the library, and close the library 
file, use the DCL command: 

REMOVE/LIBRARY name 

Note that the REMOVE/LIBRARY command makes the resident library 
inaccessible for sharing. However, the /UNLOAD qualifier, which can 
be used only with the INSTALL/LIBRARY command, only temporarily 
removes the library from memory while it is not in use. 

The UNLOAD/LIBRARY command removes a resident library from memory and 
thus frees memory that can then be used to load another library or be 
available for other system purposes. If you attempt to unload a 
resident library that is in the process of being loaded or is in use 
by the currently running job, the system prints the message: 

?Library in use 

To prevent inadvertent loss of data, the monitor does not 
automatically unload a library you have loaded with the /NOREAD_ONLY 
qualifier. Unloading a library removes it from memory but does not 
write it back to disk. This means the system discards the library and 
retrieves a new copy from the disk when it is needed again. Thus, 
anything you write to a library that you mark read/write is lost after 
you unload it with the UNLOAD/LIBRARY command. You must use the 
UNLOAD/LIBRARY command to unload a resident library that is designated 
read/wr i te . 

Whether a library remains in memory depends on the qualifiers you 
attach to the INSTALL/LIBRARY command. The /LOCK and /NOREAD_ONLY 
qualifiers prevent the monitor from removing it automatically. In 
addition, the monitor does not remove a library to which a user job is 
attached; instead, the system prints: 

PLibrary in use 



System Logical Names 

RSTS/E lets users access devices by logical names as well as by 
physical names. Logical names that apply to all users are called 
system logical names. On all systems, users can refer to a disk by 
its pack identification or by a name that replaces the pack 
identification. Thus, each disk unit configured on RSTS/E systems has 
the capability of being accessed by a system logical name. Logical 
names that apply to a single job are called job- related logical names. 
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You can define system logical names for nondisk devices and additional 
names for disk devices. The number of names is limited by the size of 
XBUF. Such a system logical name can have an account number 
associated with it. Consequently, use of the name refers not only to 
the related device but also to the account on the device. The system 
treats device names in the following manner: 

1. Checks the list of job-related logical names first. Each job 
can have up to four assigned logical names. (If the logical 
name has a $ character in it, this step is omitted.) 

2. Scans the table of disk logical names for a matching pack 
identification or equivalent. 

3. Checks the additional names. 

4. Checks the list of valid physical device names. 

If individual users have not defined job-related logical names that 
duplicate currently defined system logical names, all users have 
access to devices by the logical names the system manager adds. 

A system logical name must be unique. A pack identification or its 
logical name cannot conflict with any other pack identification or 
system logical name. However, you can define multiple system logical 
names for the same device. 

If the pack identification (or a logical name to replace the pack 
identification) of a disk you are to mount is the same as an existing 
system logical name, then RSTS/E mounts the disk with no system 
logical name. Unless you specify a different, unique name, the disk, 
at mount time, has no logical name associated with the device and unit 
being used. 

System logical names apply for a single time-sharing session; however, 
you can remove or change them during the session. DIGITAL recommends 
that you place the proper commands in START.COM to define names 
automatically at system start-up time. See the RSTS/E Programming 
Manual for more details on system logical names. 



Assigning Logical Names 

The ASSIGN/SYSTEM dev:[PPN] logical-name command defines a system 
logical name for nondisk devices or an additional name for a disk 
device. You need INSTAL privilege to use ASSIGN/SYSTEM. If the name 
duplicates one currently defined and you specify the /REPLACE=QUERY 
qualifier or you omit the /[ NO ] REPLACE qualifier, DCL prints a warning 
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message and prompts to see if you want to replace the logical. If you 
specify /NOREPLACE and the logical name is already defined, DCL prints 
the error message: 

?Logical already installed 

To change a currently defined name, use ASSIGN/SYSTEM/REPLACE command. 

The logical name must contain from 1 to 9 alphabetic or numeric 
characters. You can include the dollar sign ($) character, however, 
it must not be the first character. If the name contains illegal 
characters, DCL prints one of the the following error messages: 

?Invalid logical name 

?Unexpected character pointing to the first nonalphanumer ic 
character 

If there is no more room in XBUF, the system prints: 

?No buffer space available 

The device with which the name is associated must exist on the system. 
If it does not, the system prints: 

?Not a valid device 



Removing Logical Names 

The DEAS SIGN/SYSTEM command deletes the association defined for the 
logical name specified. You need INSTAL privilege to use 
DEAS SIGN/SYSTEM . Because a system logical name must be unique, you 
need to specify only the name in the command. If the name you include 
is not currently defined, the system prints: 

PLogical not found 

If you use an illegally formed name, the system prints one of the 
following : 

?Invalid logical name 

PUnexpected character pointing to the first nonalphanumeric 
character 

To delete all logical names for a device, you must use the 
DEAS SIGN/SYSTEM command for each currently defined name. 



12-13 



Managing System Files and Logical Names 



Listing System Logical Names 

The SHOW LOGICAL/SYSTEM command displays, for the specified logical 
name, the device designation and unit number, any account number 
associated with the logical name, and the logical name itself. If you 
do not specify a logical name, RSTS/E lists all the system logical 
names. RSTS/E displays the entries in the order in which they are 
found in the monitor tables. 



Defining Concise Command Language Commands 

Concise Command Language (CCL) commands on RSTS/E let users type 
system-level commands that load and run programs from disk. To take 
advantage of this feature, you must code your programs to recognize a 
CCL entry and to extract any command string passed to them. The 
RSTS/E Programming Manual describes the operation and interpretation 
of CCL commands. 

Certain RSTS/E programs can interpret a standard set of CCL commands. 
A RSTS/E installation can have any number of unique CCL commands. You 
make all CCL commands available to users by the DEFINE/COMMAND/SYSTEM 
command which creates the monitor structure required. You need INSTAL 
privilege to use the DEFINE/COMMAND/SYSTEM command. 

Because the monitor structure that defines a CCL command is temporary, 
CCL commands must be defined at the start of each time-sharing 
session. It is suggested that you place the proper command 
definitions in the start and crash control files. 

Each CCL command definition occupies one small buffer on the system. 
All definitions are in a linked list of small buffers. The system 
executes a SYS call to add or remove CCL definitions and provides a 
way to list all currently defined CCL commands. 



Adding a CCL Definition 

To add SY-STAT as a CCL command, execute the DEFINE/COMMAND/SYSTEM 
command as follows: 

$ DEFINE/COMMAND/SYSTEM SY-STAT [ 1 , 2 ] SYSTAT . * 

This command adds the definition for the SYSTAT system program. The 
hyphen ( - ) designates the abbreviation point so typing SY runs the 
SYSTAT program. If you do not include a hyphen in your CCL 
definition, the system places a hyphen at the end of the command and 
allows no abbreviation. RSTS/E assumes the public disk structure 
(SY:) when you do not specify a device. Programs you run with a CCL 
command can reside on any disk device, but if it is not in the public 
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structure, you must include the device in the command definition. The 
account designation [1,2] in the example means SYSTAT must reside in 
the system library. If you do not specify an account with the CCL 
command, the system assumes the program is located in the account in 
which the job (that is, the job of the user later invoking the CCL) is 
running . 

The asterisk (*) in SYSTAT.* indicates a wildcard file type. In the 
case of multiple versions of SYSTAT, the version of SYSTAT that is run 
depends on the order of the run-time systems in your run-time system 
list . 

You can specify the line number at which execution starts by appending 
the /LINE_NUMBER=n qualifier to the command. The value of n can be 
any integer from to 32767. There are standard entry points that you 
can specify by the use of keywords: 

o CCL -- 30000 

o DCL -- 30500 

o CHAIN -- 31000 

The system performs error checking before adding the CCL command. If 
the command is invalid, RSTS/E prints one of the following error 
messages : 

?Invalid command 

?Unexpected character pointing to the first nonalphanumeric 
character 

A valid command can consist of: 

o A string of 1 to 9 alphanumeric characters 

o The first character must be a letter, or one of the following 
single characters: @, $, #, %, or & 

Lowercase letters are equivalent to uppercase in the definition and 
use of CCL commands. The $ CCL is reserved; it always points to DCL. 
The command can have a maximum of nine characters. If more than nine 
characters are present, the system prints: 

?Command too long 

When you add two or more commands that begin with the same character 
or set of characters, you must define the command with the largest 
number of characters (to the left of the hyphen) first. You then 
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define the command with the next fewest characters to the left of the 
hyphen, until you have made all the assignments. For example, you 
must define MACR-O before adding MAC-, or RSTS/E prints: 

?Command not unique 

This message also appears if you attempt to define a command that was 
already defined. 

If you need to add a longer CCL definition after you have already 
added a similar but shorter one, you must first remove the shorter 
entry. You then add the longer CCL command which lets you reinstall 
the CCL with the shorter command name. For example, if you had 
installed MAC - and at some later date needed to add MACR-O, you would 
have to remove MAC-, install MACR-O, and then reinstall MAC-. The 
section "Removing a CCL Definition" describes how to remove CCL 
entries . 



Listing Currently Defined CCL Commands 

The SHOW COMMAND/SYSTEM command prints a listing of all currently 
defined CCL commands. You can also list a single CCL command with the 
SHOW/COMMAND/SYSTEM <name> command. You need INSTAL privilege to 
execute the SHOW COMMAND/SYSTEM command. The list of CCL commands on 
your system may contain some of the following: 



$ SHOW COMMAND/SYSTEM 
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] LOGIN 




/LINE- 
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,2 
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SY 
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,2 
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HELL - 
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,2 
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,2 
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.SAV 
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/LINE= 
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$ 
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The system prints the commands in the order in which they were 
defined. If no CCL commands are currently defined, the system prints 
the message: 

%No Commands installed 

Note 

When you start the system, the monitor automatically 
installs the $ CCL. DIGITAL recommends that you do 
not redefine the $ CCL. 

The $ CCL lets you issue DCL commands from any 
command environment. For example, from BASIC-PLUS 
you can type: 

Ready 

$ MOUNT DLO : MINDY/NOSHARE <RET> 
Ready 



Removing a CCL Definition 

To remove a CCL definition, type the command DELETE/COMMAND/SYSTEM 
followed by the definition. You need INSTAL privilege to execute the 
DELETE/COMMAND/SYSTEM command. You can type either a full definition 
or a valid abbreviation to indicate the command you plan to remove: 

$ DELETE/COMMAND/SYSTEM MYPR-OG 

If the definition does not currently exist, the system prints: 

PCommand not found 

If the definition exists, the command removes the CCL definition 
immediately. You can delete all the CCL commands by appending the 
/ALL qualifier to the DELETE/COMMAND/SYSTEM command. For example: 

$ DELETE/COMMAND/SYSTEM/ALL 



System File Control 

You allocate and position the following system files on 
file - structured disks by executing the INSTALL/SWAP_FILE , 
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INSTALL/OVERLAY_FILE, or INSTALL/ERROR_FILE commands: 
o SWAP 0. SYS 
O SWAPl.SYS 
O SWAP 3. SYS 
o OVR.SYS 
O ERR. SYS 

These optional files optimize system performance by taking advantage 
of higher speed disks and the characteristics of user jobs running on 
the system. Because the files are contiguous and contiguous space 
becomes scarce as user files are created during timesharing, 
preallocation and prepositioning are necessary. The RSTS/E 
Installation and Update Guide describes the planning considerations 
for preallocating and positioning these system files. 

RSTS/E does not automatically access these system files. You control 
RSTS/E access to these files with DCL commands. Thus, the use of 
these files during timesharing is dynamic. If a hardware problem 
occurs on a swap device, you can remove the device without stopping 
timesharing. To maintain the same amount of swap space, you can 
designate a private disk as the swap device. 

This section discusses the DCL commands that control system file 
usage. The commands in the start-up control file allow access to 
system files at the start of time-sharing operations. 



Adding and Removing Swap Files 

The swap files SWAPO.SYS, SWAPl.SYS and SWAP 3 . SYS in account [0,1] are 
standardized names for the three optional swap files. While these 
names are optional, DIGITAL recommends you use them because they 
indicate the characteristics of the files. You can, however, assign 
any file name to these three swap files. The system restricts the 
file type to .SYS regardless of the file names you include in the DCL 
commands . 

The INSTALL/SWAP_FILE command causes the system to access a specific 
file (if a file - structured device is involved) or a specific device 
(if a non- file - structured disk is involved). You need INSTAL 
privilege to execute the INSTALL/SWAP_FILE command. A typical command 
sequence is: 

$ INSTALL/SWAP_FILE=0 DR3:SWAP0 
$ INSTALL/SWAP__FILE=1 DRl-.SWAPl 
$ INSTALL/SWAP FILE=3 DR4:SWAP3 
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Note 

When you specify a non - file - structured device in the 
INS TALL/SWAP__F I LE command, the monitor destroys any 
existing file structure on that device. 

The /SIZE=n qualifier of the INSTALL command allows online creation of 
a swap file during timesharing. The qualifier is most useful when you 
want to add a swap file to a private disk that contains sufficient 
contiguous space for the file. The value n in the /SIZE=n qualifier 
represents the number of blocks in the file. RSTS/E attempts to 
access the file with a file type of .SYS in account [0,1] on the 
associated device. If the file size differs from the size specified 
in the /SIZE=n qualifier, RSTS/E prints a warning message in the 
format : 

NOTE -- THE SIZE OF file. SYS IS x NOT n. 

The value x is the actual size and n is the value in the /SIZE=n 
qualifier. 

If the file does not exist, the system attempts to create a contiguous 
file of the size specified. If there is not enough contiguous space 
available to create the file, the system prints: 

?Not enough contiguous space to create System file 

The /POSITION=n qualifier lets you place the created swap file in a 
particular location on the specified disk. The monitor ignores this 
qualifier if the already exists. 

After you type the INSTALL/SWAP_FILE command, the system tries to 
install the particular file or device as the swap file. If the system 
finds any errors, RSTS/E prints an error message in the following 
format: 

Error text -- in INSTALL SWAP_FILE 

Appendix D contains a list of the possible errors. If no errors 
occur, the system installs the swap file. 

You can then activate the added swap file with the SET SYSTEM/LOGINS 
command. The SET SYSTEM/LOGINS command forces the system to examine 
all swap file space and to calculate the number of jobs the system is 
capable of running. 
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During timesharing, the number of jobs that can run on the system 
depends on: 

o The job maximum (JOB MAX) set at system generation 
o The amount of swap space added 

o The number of logins allowed through the SET SYSTEM/LOGINS 
command 

At the start of timesharing, the number of logins allowed is one. One 
job is necessary for the DCL START.COM file to run. You can increase 
this number by using the SET SYSTEM/LOGINS command, but the number is 
restricted by the swap space available and by JOB MAX. When you add 
swap space with INSTALL/SWAP_FILE commands, the capacity to handle 
logins is increased. The SET SYSTEM/LOGINS command sets the number of 
logins to the maximum allowed. This maximum cannot exceed JOB MAX. 

RSTS/E lets you dynamically remove as well as add swap files 0, 1, and 
3. To remove a swap file or device, first decrease the number of 
logins using the SET SYSTEM/NOLOGINS or SET SYSTEM/LOGINS n command. 
The number of logins to be decreased depends on the capacity of the 
swap file to be removed. By decreasing the number of logins, you 
allow the system to safely remove swap space. 

The sequence of commands to remove a swap file is the reverse of the 
sequence to add swap space. For example, assume that a system is 
running with a JOB MAX of 63 and is using a swap file with a capacity 
of 16 jobs. In this case, you must decrease the number of logins by 
16 jobs before removing the swapfile. The following sequence shows 
this procedure: 

$ SET SYSTEM/LOGINS^47 
§ REM0VE/SWAP_FILE=1 
$ 

In practice, it may take some time for the system to adjust 
operations. If the number of jobs currently running is greater than 
47 or if the number of logins allowed is too large, the system prints 
the error message: 

?Too many logins allowed to remove Swap file 

You must wait until users log out of the system. The SHOW BUFFERS 
command or the DISPLY program prints the number of jobs currently on 
the system in the free buffer status report. (The SHUTUP program 
automatically removes swap files.) 

It is possible to add more swap space than the system can use. In 
this case, you do not need to reduce logins to remove a swap file. 
However, enough room must remain to swap all jobs currently logged in, 
or to swap all jobs that can log in, whichever is greater. 



12-20 



Managing System Files and Logical Names 



The SHOW FILE/SYSTEM command provides a way for you to verify that the 
following files exist on your system: 

o Swap files (/SWAP_FILE) 

o Overlay file (/OVERLAY_FILE ) 

o Error file ( /ERROR_FILE ) 

o DECnet/E Network Services Protocol (NSP) system file 
(/NETWORK__FILE) 

This command is most useful when you want to verify the addition or 
removal of any of these files. After adding a file, you can use the 
SHOW FILE/SYSTEM/SWAP_FILE command to verify, for example, that you 
gave the file the correct file specification, or that the file was 
added properly. If you add a swap file, such as DR3 : [ , 1 ] SWAPO . SYS , 
execute the SHOW FILE/SYSTEM/SWAP_FILE command as follows: 

$ SHOW FILE/SYSTEM/SWAP__FILE 

DR3 : [ , 1 ] SWAPO .SYS 10240 blks (40 jobs at 64K Swap max) 
None 

DR1: [0,1] SWAP .SYS 256 blks (1 job at 64K Swap max) 
DR4 : [ , 1 ] SWAP 3 .SYS 1000 blks (3 jobs at 64K Swap max) 

$ 



Swapfile 0: 
Swapfile 1: 
Swapfile 2: 
Swapfile 3: 



RSTS/E prints None beside the files that do not exist. Note that the 
system cannot add or remove the DECnet/E file but can only verify that 
the file exists on your system. There is no DCL command to add or 
remove this file. Refer to the SET SYSTEM and CLEAR SYSTEM commands 
in the DECnet/E System Manager ' s Guide for further information. 



Adding and Removing Overlay and Error Files 

You can add and remove the overlay and error message files during 
timesharing. OVR and ERR are standardized names to denote the 
separate file for the overlay code and the alternate file for the 
default error message file. Although you can use other file names, 
DIGITAL recommends that you keep the standardized ones. Regardless of 
the names you give the files, the system requires you to use a file 
type of .SYS. You need INSTAL privilege to use the INSTALL command. 

The I NS TALL/OVERLAY_F I LE command directs the system to use the 
specified file for the system overlay code. Similarly, the 
INSTALL/ERROR__FI LE command causes the system to use the specified file 
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when it reads error messages. To add these system files, specify the 
commands as in the following example: 

$ INSTALL/OVERLAY_FILE DU2 : OVR 
$ INSTALL/ERROR_FILE DBO : ERR 

For the overlay file, the system copies the overlay code from the 
monitor SIL to the file OVR. SYS on DU unit 2. For the error message 
file, the system copies into ERR. SYS on DB unit the contents of the 
error message file (ERR. ERR). You must make sure that the! disk on 
which an overlay or error file resides is mounted when you issue this 
command. As with swap files, you can use the /SIZE and /POSITION 
qualifiers for overlay and error files. 

To install these files, the system makes sure that the files exist and 
are properly formed. If the system finds any errors, it prints the 
error messages in the following format: 

Error text in INSTALL/OVERLAY_FILE 

Error text In INSTALL/ERROR_FILE 

Appendix D contains the text of these errors. If no errors occur, the 
system has successfully added the file and is accessing it. You do 
not need to enter any further commands. 

You can remove these files at any time with the REMOVE/OVERLAY__F I LE 
and REMOVE/ERROR__FILE commands. Then, the system accesses the 
original data. Note that the SHUTUP program automatically removes 
both files. 



Using the DUMP/SYSTEM Command 

The DUMP/SYSTEM command lets you take an online dump of the current 
monitor image executing in memory. When you execute the DUMP/SYSTEM 
command, RSTS/E copies the memory to the crash dump file CRASH. SYS in 
account [0,1]. You need SYSIO privilege to use the DUMP/SYSTEM 
command. Use the DUMP/SYSTEM command as follows: 

$ DUMP/SYSTEM 

Once the copy operation is complete, you can use the ANALYS program to 
analyze the contents of the file (see Chapter 10). 

The system returns the following error message if crash dump was not 
enabled : 

?Can't find file or account 



12-22 



Managing System Files and Logical Names 



This can happen only if sufficient disk space was not available at 
system start-up to allocate the CRASH. SYS file. To correct this 
condition, free up the necessary amount of disk space, shut down and 
then restart the system. 

If a user who does not have SYSIO privilege attempts to dump memory 
with DUMP/SYSTEM, the system prints: 

?Protection violation 

Use of the DUMP/SYSTEM command may also return various device 
dependent errors. For example: 

?Device hung or write locked 



DCL Command Descriptions 

The following sections describe the 
files and logical names. 



DCL commands for managing system 
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ASSIGN/SYSTEM Command 

The ASSIGN/SYSTEM command assigns a system-wide logical name to the 
specified device type and unit. If you include an account number, the 
ASSIGN/SYSTEM command also associates that project-programmer number 
with the logical name. ASSIGN/SYSTEM requires INSTAL privilege. 

+ - + 

| Format I 

| ASSIGN/SYSTEM dev:[p,pn] name[:] | 

| Command Qualifiers Defaults | 

| / [NO] REPLACE [=QUERY] /REPLACE=QUERY | 

| Prompts | 

| Device: | 
| Logical name: I 
+ + 

Command Parameters 

dev : 

Specifies the device type and unit to which you want to assign a 
system-wide logical name. 

( P / pn ] 

The optional PPN to which you want to assign a system-wide 
logical name. DCL does not allow any spaces between the device 
specification and the PPN. 

name [ : ] 

The name that you want added to the system logical name table. 

Command Qualifiers 

/ [ NO ] REPLACE [ =QUERY ] 

Determines what action to take if the logical name already 
exists. /REPLACE means replace the logical if it already exists. 
RSTS/E displays an informational message. 

/NOREPLACE means display an error message and do not replace the 
logical if it already exists. If neither is specified or if 
/REPLACE=QUERY is specified, RSTS/E displays a warning message 
and prompts to see if you want to replace the logical. 
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DEAS SIGN/SYSTEM Command 

The DEAS SIGN/SYSTEM command removes a specified logical name from the 
system logical table. It can also remove logical names for devices on 
your system. Device mnemonic names for system devices have permanent 
entries in the logical table. So, if you use the DEAS SIGN/SYSTEM 
command to remove a logical name associated with a device, only the 
logical name goes away, not the device mnemonic. You can then give a 
new name to that device. DEAS SIGN/SYSTEM requires INSTAL privilege. 

+ + 

| Format | 

| DEAS SIGN/SYSTEM name [ : ] | 

I Command Qualifiers Defaults | 

| None | 

| Prompts I 

| Logical name: | 
+ + 

Command Parameters 

name [ : ] 

Specifies the logical name to be removed from the system logical 
table . 
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DEFINE/COMMAND/SYSTEM Command 

The DEFINE/COMMAND/SYSTEM command creates or re -defines a system-wide 
command (CCL). DEFINE/COMMAND/SYSTEM requires INSTAL privilege. 



Format 

DEFINE/COMMAND/SYSTEM command file -spec 

Command Qualifiers Defaults 

/LINE_NUMBER=entry point 
/[NO]PRIVILEGE 

Prompts 

Command : 
Program name: 

+ + 

Command Parameters 
command 

Specifies the command you want to define, 
file - spec 

Specifies the file you want to associate with the command. 
Command Qualifiers 
/LINE_NUMBER=entry point 

Defines the entry point in the command program as follows: 

o n -- Defines the entry point as the specified integer in the 
range to 32,767 

o CCL -- Defines the entry point as the CCL entry point (30000) 

o CHAIN -- Defines the entry point as the CHAIN entry point 
(31000) 

o DCL -- Defines the entry point as the DCL entry point (30500) 
/[NO]PRIVILEGE 

Specifies whether the program needs to retain its temporary 
privileges (see Chapter 6). 
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DELETE/COMMAND/SYSTEM Command 

The DELETE/COMMAND/SYSTEM command deletes the specified command from 
the list of defined system-wide commands (CCLs). 
DELETE/COMMAND/SYSTEM requires INSTAL privilege. 

+ + 

| Format | 

| DELETE/COMMAND/SYSTEM command | 

| Command Qualifiers Defaults | 

I /ALL I 

| Prompts | 

| Command: | 
+ + 

Command Parameters 

command 

Specifies the command to be deleted from the list of defined 
system-wide commands. 

Command Qualifiers 

/ALL 

Deletes all system-wide commands. 
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DUMP/SYSTEM Command 

The DUMP/SYSTEM command records in the CRASH. SYS file the current 
state of the system so you or field service has a way to investigate 
reasons for system malfunctions. DUMP/SYSTEM requires SYSIO 
privilege. 

+ + 

| Format I 

| DUMP/SYSTEM | 

| Command Qualifiers Defaults | 

| None | 

| Prompts | 

| None | 
+ + 

The DUMP/SYSTEM command has no qualifiers or prompts. 
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INSTALL/ERROR_FILE Command 

The INSTALL/ERROR_FILE command installs the specified file as the 
system error message file. INSTALL/ERROR_FILE requires INSTAL 
privilege . 



+ 

Format 

INSTALL/ERROR_FILE file -spec 

Command Qualifiers 

/POSITION=dcn 
/SIZE=n 

Prompts 

Error file: 
+ 



+ 



Defaults 



+ 



Command Parameter 
file-spec 

Specifies the file to be installed as the system error message 
file. 

Command Qualifiers 

/POSITION=dcn 

Places the error file at the specified position on the disk. You 
must also specify the /SIZE=n qualifier. The value of position 
can be one of the following: 

Value Meaning 

den Locate the file at the first available position on 

the device past the specified Device Cluster Number. 

MIDDLE Locate the file at the first available position past 
the middle of the device. 

INDEX Locate the file at the first available position past 
the Master File Directory (MFD) index. 

/SIZE=n 

Creates a system file with a size of n blocks. The /SIZE=n 
qualifier is required if the file does not already exist. 
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INSTALL/LIBRARY Command 

The INSTALL/LIBRARY command adds the named library to the list of 
installed resident libraries. INSTALL/LIBRARY requires INSTAL 
privilege. 



Format 



INSTALL/LIBRARY name 

Command Qualifiers Defaults 



/[NO] ADDRESS [=n] 
/[NO ] ERROR__LOGGING 
/[NO] LOCK 
/PROTECTIONS 
/[NO]READ_ONLY 
/[NO] SHAREABLE 
/[NO] UNLOAD 



See discussion 
/ERROR__LOGGI NG 
/NOLOCK 

/PROTECTION=42 
/READJDNLY 
/SHAREABLE 
/NOUNLOAD 



Prompts 
Library : 



Command Parameters 



name 



Specifies the name of the library to add to the list of installed 
resident libraries. 



Command Qualifiers 
/[NO] ADDRESS [=n] 

Indicates that the resident library should be loaded into memory 
in lK-word sections beginning at address n. Specifies the . 
address in memory to load the resident library. Values can be in 
the range IK to 1919K. 



If n is omitted, RSTS/E computes the starting address by finding 
the highest memory segment large enough to hold the named 
library. If this qualifier is omitted, RSTS/E computes a new 
starting address each time it loads the named library into 
memory. 
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/ [ NO ] ERROR_LOGGING 

Indicates whether errors that occur within the resident library 
should be recorded in the system error log. The /ERROR_LOGGING 
qualifier logs any errors that occur in the resident library to 
the system error log. The /NOERROR__LOGGING qualifier prevents 
errors that occur within the resident library from being recorded 
in the system error log. The default is /ERROR_LOGGING . 

/[NOJLOCK 

Indicates whether the resident library should remain in memory. 
The /LOCK qualifier locks the resident library in memory. The 
/NOLOCK qualifier unlocks the resident library from memory. The 
default is /NOLOCK. 

/PROTECTIONS 

Sets the protection code of the resident library. The default 
code is 42. 

/[NO] READ-ONLY 

Indicates the allowable type of access to the resident library. 
The /READ_ONLY qualifier allows read-only access to the resident 
library. The /NOREAD_ONLY qualifier allows the resident library 
to be mapped read/write. The default is /READ__ONLY. 

/[NO] SHAREABLE 

Indicates how many users can access the resident library 
simultaneously. The /SHAREABLE qualifier lets more than one user 
access this resident library at the same time. The /NOSHAREABLE 
qualifier lets only one user access the resident library at any 
time. The default is /SHAREABLE. 

/[NO] UNLOAD 

Indicates whether the resident library should remain in memory 
when no jobs are using it. The /UNLOAD qualifier removes the 
resident library from memory whenever there are no jobs using it. 
The /NOUNLOAD qualifier keeps the resident library in memory even 
when there are no jobs using it. The default is /NOUNLOAD. 
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INSTALL/OVERLAY_FILE Command 

The INSTALL/OVERLAY__FILE command installs the specified file as the 
system overlay file. INSTALL/OVERLAY_FILE requires INSTAL privilege. 



+ 

Format 

INSTALL/OVERLAY_FILE file -spec 

Command Qualifiers Defaults 

/POSITION=dcn 
/SIZE=n 

Prompts 

Overlay file: 

+ + 

Command Parameters 
file - spec 

Specifies the file to be installed as the system overlay file. 
Command Qualifiers 
/POSITION=dcn 

Places the overlay file at the specified position on the disk. 
The /SIZE=n qualifier is required. The value of position can be 



one of the following: 
Value 



Meaning 



den Locate the file at the first available position on 

the device past the specified Device Cluster Number. 

MIDDLE Locate the file at the first available position past 
the middle of the device. 

INDEX Locate the file at the first available position past 
the Master File Directory (MFD) index. 

/SIZE=n 

Creates a system file with a size of n blocks. 
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INSTALL/RUNTIME_J3YSTEM Command 

The INSTALL/RUNTIME_SYSTEM command adds the named run- time system to 
the list of installed run- time systems. INSTALL/RUNTIME_SYSTEM 
requires INSTAL privilege. 



Format 

INSTALL/RUNTIME_SYSTEM name 

Command Qualifiers 

/[ NO ] ADDRESS [ =n ] 

/[NO ] ERROR_LOGGING 

/ [ NO ] KEYBOARD_MONI TOR 

/[NOJLOCK 

/MAXIMUM_SIZE=S 

/MINIMUM_SIZE=S 

/POSITION=n 

/PREFIX[=x] 

/ [ NO ] READ_ONL Y 

/[NO] SHAREABLE 

/TYPE=f iletype 

/[NO] UNLOAD 

Prompts 

Run-time system: 



Command Parameters 



name 



Defaults 

See discussion 
/ERROR_LOGGING 
/NOKE YBOARD_MONI TOR 
/NOLOCK 



at end of list 

/PREFIX=255 

/READ_ONLY 

/SHAREABLE 

See discussion 

/NOUNLOAD 



+ 



Specifies the name of the run-time system to be added to the list 
of installed run-time systems. 

Command Qualifiers 



/[ NO ] ADDRESS [ =n ] 

Specifies the address in memory to load the run-time system. The 
value of n can be in the range IK to 1919K. If n is omitted, 
RSTS/E computes the starting address by finding the highest 
memory segment large enough to hold the name run- time system. 

If the qualifier is omitted, RSTS/E computes a new starting 
address each time it loads the name run-time system into memory. 
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/[NO ] ERROR_LOGGING 

Indicates whether the run-time system should log errors occurring 
under its control to the system error file. The /ERROR__LOGGING 
qualifier indicates that this run-time system should log errors. 
The /NOERROR__LOGGI NG qualifier indicates that it should not log 
errors. The default is /ERROR__LOGGING. 

/[NO ] KE YBOARD_MON I TOR 

Indicates whether the run- time system has a keyboard monitor. 
The /KEYBOARD_MONI TOR qualifier indicates that this run-time 
system is a keyboard monitor. The /NOKEYBOARD__MONITOR qualifier 
indicates that this run-time system is not a keyboard monitor. 

/[NO]LOCK 

Indicates whether the run-time system should reside permanently 
in memory. The /LOCK qualifier indicates that the run-time 
system should reside permanently in memory. The /NOLOCK 
qualifier indicates that the run-time system should not reside 
permanently in memory. The default is /NOLOCK. 

/MAX I MUM_S I Z E= S 

Uses s in K words as the maximum job size. 
/MINIMUM__SIZE=S 

Uses s in K words as the minimum size job allowed. 
/POSITION=n 

Places the run-time system block in position n after the primary 
run-time system in the linked list. By default, RSTS/E positions 
the run- time system at the end of the list. N can be any number 
in the range from to 255. 

/PREFIX[=x] 

Causes the run-time system to use the RSTS/E special prefix EMT 
feature. The value x can be any number from to 255. RSTS/E 
selects the code 255 by default if you do not specify a value for 
x . 

/ [ NO ] READ__ONLY 

Indicates whether the run-time system should allow read-only 
memory access. The /READ__ONLY qualifier indicates read-only 
memory access. The /NOREAD__ONLY qualifier indicates read/write 
memory access. The default is /READ_ONLY. 
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/[NO] SHAREABLE 

Indicates whether the run-time system supports multiple users. 
The /SHAREABLE qualifier indicates that the run- time system 
supports more than one user at the same time. The /NOSHAREABLE 
qualifier indicates that the run-time system supports only one 
job at a time. The default is /SHAREABLE. 

/TYPE=f iletype 

Specifies the default file type for files executed under the 
run-time system. By default, DCL uses the file type defined in 
the run-time system file. 

/[NO] UNLOAD 

Specifies whether RSTS/E unloads the run-time system from memory 
when no one is using it. The /UNLOAD qualifier removes the 
run-time system from memory when all users are using another 
run-time system or when no jobs are using the run-time system. 
The /NOUNLOAD qualifier keeps the run- time system in memory even 
when no jobs are using it. The default is /NOUNLOAD. 
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I NST ALL/SWAP_F I LE Command 



The INSTALL/SWAP__FILE command adds the specified file to the list of 
installed swap files. Valid values of swap-index are 0, 1, or 3. 
INSTALL/SWAP__FILE requires INSTAL privilege. 



Format 

INSTALL/SWAP_FILE[ = ] swap- index file- spec 
Command Qualifiers Defaults 



/POSITION=dcn 
/SIZE=n 

Prompts 

Swapfile number: 
Swapfile name: 



Command Parameters 
swap- index 

Specifies the index of the specified file. Valid values are 0, 
1 , and 3 . 

file - spec 

Specifies the file to add to the list of installed swap files. 
You must specify the disk. 
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Command Qualifiers 
/POSITION=dcn 

Places the created system file at the specified position on the 
disk. You must also specify the /SIZE=n qualifier. The value of 
position can be one of the following: 

Value Meaning 

den Locate the file at the first available position on 

the device past the specified Device Cluster Number. 

MIDDLE Locate the file at the first available position past 
the middle of the device. 

INDEX Locate the file at the first available position past 
the Master File Directory (MFD) index. 

/SIZE=n 

Creates a system file with a size of n blocks. The /SIZE=n 
qualifier is required if the file does not already exist. 
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REMOVE/ERROR_FILE Command 

The REMOVE/ERROR__F I LE command removes the system error message file. 
REMOVE/ERROR_FILE requires INSTAL privilege. 

+ + 

j Format j 

| REMOVE/ERROR_FILE | 

| Command Qualifiers Defaults | 

| None | 

I Prompts j 

| None | 
+ - - - + 

This command has no qualifiers or prompts. 
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REMOVE/LIBRARY Command 

The REMOVE/LIBRARY command removes the named file as a resident 
library. REMOVE/LIBRARY requires INSTAL privilege. 



Format 

REMOVE/LIBRARY name 

Command Qualifiers 

None 

Prompts 

Library: 



Defaults 



Command Paramters 



name 



Specifies the file to remove from the list of resident libraries 
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REMOVE/OVERLAY__FILE Command 



The REMOVE/OVERLAY_FILE command removes the system overlay file 
REMOVE/OVERLAY_FILE requires INSTAL privilege. 



Format 

REMOVE/OVERLAY_FILE 

Command Qualifiers Defaults 
None 
Prompts 
None 

This command has no qualifiers or prompts. 
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REMOVE/RUNT IMEJSYSTEM Command 

The REMOVE/RUNT I ME__S YS TEM command removes the named run -time system as 
an entry in the run- time system table. REMOVE/RUNTIME_SYSTEM requires 
INSTAL privilege. 

+ + 

j Format | 

| REMOVE/RUNTIME_SYSTEM name | 

| Command Qualifiers Defaults | 

| None j 

j Prompts j 

| Run-time system: j 
+ + 

Command Paramters 

name 

Specifies the name of the run-time system to remove from the list 
of installed run-time systems. 
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REMOVE/SWAP_FILE Command 

The REMOVE/SWAP__FILE command removes the specified swap file from the 
list of installed swap files. Valid values of swap-index are 0, 1, or 
3. REMOVE/SWAP_FILE requires INSTAL privilege. 

+ + 

I Format j 

| REMOVE/SWAP_FILE[=] swap- index j 

| Command Qualifiers Defaults | 

j None j 

| Prompts | 

| Swapfile number: j 
+ + 

Command Parameters 

swap- index 

Specifies the index of the swap file to remove. Valid values are 
, 1 , or 3 . 
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SET FILE Command 

The SET FILE command changes the characteristics of the specified 
file(s). SET FILE requires read and write access to the file(s). 



Format 



SET FILE file-spec 

Command Qualifiers Defaults 

/[NO] CACHE 
/NOCONTIGUOUS 

/[ NO ) DELETABLE /DELETABLE 
/[NO] LOG /NOLOG 
/[NO] PLACED 
/PROTECTIONS 
/RUNTIME SYSTEM=name 



Prompts 
Files: 

+ + 

Command Parameters 



file - spec 



Specifies the file whose characteristics you want to change. 



Command Qualifiers 



/[ NO] CACHE[={ SEQUENTIAL | RANDOM} ] 

The /CACHE qualifier specifies that the file is automatically 
cached when open. The type of caching depends on the file's UFD 
entry and the specified OPEN MODE. If you use /CACHE alone on a 
file with no UFD setting or MODE specification, the default is 
random caching. TUNE privilege is required to use this 
qualifier . 



The optional arguments are: 



o SEQUENTIAL -- Causes RSTS/E to mark the file's UFD entry such 
that, if the file is cached, it is cached sequentially. 



o RANDOM -- Causes RSTS/E to mark the file's UFD entry so, if 
the file is cached, it is cached randomly. Note that you can 
override the random cache UFD setting with a sequential 
caching MODE specification. 
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The /NOCACHE qualifier specifies that the file is not 
automatically cached when open. To cache such a file, you must 
specify SET CACHE/ALL or specify a MODE value (see the RSTS/E 
Programming Manual ) . 

/NOCONTIGUOUS 

Lets you extend a contiguous file by changing it to 
noncontiguous. 

/[ NO ] DELETABLE 

Indicates whether a file can be deleted or renamed during 
timesharing. In a directory listing, RSTS/E shows NODELETABLE 
files with the flag P (protected) after their size. You need 
SYSIO privilege to use this qualifier. The default is 
/DELETABLE. 

/[NO] LOG 

Indicates whether the file specification of each modified file is 
displayed at the terminal. If the file specification contains 
any wildcards, the default is /LOG. Otherwise, the default is 
/NOLOG . 

/[NO] PLACED 

Indicates whether, after modification, a file is placed at its 
present position on the disk. 

/PROTECTIONS 

Sets the protection code of a file. The protection code must be 
in the range to 255. You can also use the SET PROTECTION 
command to perform this function. You need SYSIO privilege to 
set the privilege bit of the protection code. 

/RUNTIME_SYSTEM=name 

Associates a run-time system with the file. The file-spec can be 
any valid RSTS/E file specification. When the system tries to 
execute this file, it uses the named run-time system to load the 
executable file. You need SYSIO privilege to use this qualifier 
for file(s) whose protection code is 192 or higher. 
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SHOW COMMAND/SYSTEM Command 

The SHOW COMMAND/SYSTEM command displays information about the 
specified system- wide command. SHOW COMMAND/SYSTEM requires INSTAL 
privilege . 



Format 

SHOW COMMAND/SYSTEM command -name 

Command Qualifiers 

/ALL 

Prompts 

None 



Defaults 

/ALL 



Command Parameters 
command -name 

Specifies the system-wide command whose information you want 
displayed. If you do not include this parameter, RSTS/E displays 
all system commands. 

Command Qualifiers 

/ALL 

Displays information about all the system-wide commands. 
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SHOW FILE/SYSTEM Command 

The SHOW FILE/SYSTEM command displays information about the specified 
system file(s). The default is /ALL. SHOW/FILE/SYSTEM does not 
require any privilege. 



Format 

SHOW FILE/SYSTEM 
Command Qualifiers 
/ALL 

/ERROR__FILE 
/NETWORK__FILE 
/OVERLAY_FILE 
/SWAP_FILE[ =swap- index ] 

Prompts 

None 



Defaults 
/ALL 

all swap files 



+ 



Command Qualifiers 
/ALL 

Displays information about all installed files. 
/ERROR__FILE 

Displays information about the system error message file. 
/NETWORK_FILE 

Displays information about the network database file. 
/OVERLAY__FILE 

Displays information about the system overlay file. 

/SWAP_FILE[ =swap- index ] 

Displays information about the specified swap file, where 

swap- index is 0, 1, or 3. If no argument is given, RSTS/E lists 

all swap files. 
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SHOW LIBRARY Command 



The SHOW LIBRARY command displays information about all installed 
libraries. SHOW LIBRARY does not require any privilege. 



Defaults 



+ 

Format 

SHOW LIBRARY 
Command Qualifiers 
None 
Prompts 
None 

+ 

The SHOW LIBRARY command has no qualifiers or prompts. 
The following is an example of the SHOW LIBRARY display: 
$ SHOW LIBRARY 



+ 



- + 



Resident 
Name P 
HISTOG 
CSPLIB 
RMSRES 
RMSLBB 
RMSLBA 
RMSLBD 
RMSLBC 
RMSLBE 
RMSLBF 
DAPRES 
EDT 

B2MRES 



Libraries : 
rot 
42> 
42> 
42> 
42> 
42> 
42> 
42> 
42> 
42> 
42> 
42> 
42> 





Acct 


Size 


Users 


Comments 


[ 1,2 ] 


36K 





Perm, Addr:1628 


DR1 


:[ 0,1 ] 


8K 


8 


Temp, Addr:117 


DR1 


:[ 0,10 ] 


4K 


1 


Temp, Addr:1624 


DR1 


:[ 0,10 ] 


3K 


1 


Temp, Addr:1621 


DR1 


:[ 0,10 ] 


4K 





Temp, Addr:1617 


DR1 


:[ 0,10 ] 


2K 





Temp, Addr:1615 


DR1 


:[ 0,10 ] 


2K 





Non-Res, Addr:1613 


DR1 


:[ 0,10 ] 


3K 





Temp, Addr:1610 


DR1 


:[ 0,10 ] 


4K 





Temp, Addr:1606 


DRl , 


:[ 0,10 ] 


10K 





Temp, Addr:876 


DR1 


:[ 0,11 ] 


38K 


1 


Temp, Addr:1568 


DRl 


:[ 0,1 ] 


19K 





Temp, Addr:830 
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SHOW LOGICALS Command 

The SHOW LOGICALS command displays information about a user -defined 
logical name. SHOW LOGICALS does not require any privilege. 



Format 

SHOW LOGICALS name 

Command Qualifiers 

/ALL 

Prompts 

None 



Defaults 

/ALL 



Command Parameters 



name 



Specifies the user-defined logical name whose information you 
want displayed. 

Command Qualifiers 

/ALL 

Displays information about all user-defined logical names. 
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SHOW LOGICAL/SYSTEM Command 



The SHOW LOGICAL/SYSTEM command displays information about a 
system-wide logical name. You need SYSIO privilege to use SHOW 
LOGICAL/SYSTEM. 



+ 



+ 



Format 



SHOW LOGICAL/SYSTEM name 



Command Qualifiers 



Defaults 



/ALL 



/ALL 



Prompts 



None 



+ 



+ 



Command Parameters 
name 

Specifies the system-wide logical name whose information you want 
displayed . 

Command Qualifiers 

/ALL 

Displays information about all system-wide logical names. 
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SHOW RUNTIME_SYSTEM Command 

The SHOW RUNTIME__SYSTEM command displays information about all 
installed run- time systems. SHOW RUNTIME_SYSTEM does not require any 
privilege . 

+ - + 

| Format | 

| SHOW RUNTIME_SYSTEM j 

I Command Qualifiers Defaults j 

| None j 

| Prompts | 

| None j 
+ + 

The SHOW RUNTIME_SYSTEM command has no qualifiers or prompts. The 
following is an example of the display: 

$ SHOW RUNTIME_SYSTEM 

Run-Time Systems: 



Name 


Ext 


Dev 


Size 


Users 


Comments 






. . .RSX 


TSK 




0(64)K 


14 


Monitor 






RSX 


TSK 


DR1 : 


1(28)K 





Primary, Perm, Addr: 


76, KBM 




DCL 


COM 


DR1 : 


28( 4 )K 


8 


Temp, Addr: 77, DF KBM 




RT11 


SAV 


DR1: 


4(28)K 





Temp, Addr: 109, KBM, 


CSZ, EMT: 


255 


TECO 


TEC 


DR1 : 


10(20)K 





Temp, Addr: 383, KBM 






BAS4AL 


BAC 


DR1 : 


17(12)K 





Non-Res, KBM, CSZ 






BAS4F 


BAC 


DR1 : 


16(16)K 





Temp, Addr: 322, KBM, 


CSZ 




BASIC 


BAC 


DR1 : 


15(16)K 


1 


Temp, Addr: 133, KBM, 


CSZ 




FORTH 


4TH 


DR1 : 


6(24)K 





Temp, Addr: 125, KBM, 


NER, CSZ 




GMBODT 


COM 


DRO: 


27(4)K 





Non-Res, Addr:1541, 


KBM, 1US, 


R/W 


MOMODT 


COM 


DRO : 


27(4)K 


1 


Temp, Addr: 849, KBM, 


1US, R/W, 


NER 
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UNLOAD/LIBRARY Command 

The UNLOAD/LIBRARY command removes the resident library you specify 
from memory. UNLOAD/LIBRARY requires the INSTAL privilege. 



Format 

UNLOAD/LIBRARY name 

Command Qualifiers 

None 

Prompts 

Library: 



Defaults 



Command Parameters 



name 



Specifies the name of the resident library to remove from memory 
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UNLOAD/RUNTIME_SYSTEM Command 



The UNLOAD/RUNT I ME_SYSTEM command unloads the named run -time system 
from memory. UNLOAD/RUNT I ME_SYSTEM requires the INSTAL privilege. 



Format 

UNLOAD/RUNT I ME_SY STEM name 

Command Qualifiers Defaults 

None 

Prompts 

Run-time system: 



+ 



Command Parameters 



name 



Specifies the name of the run-time system to remove from memory 
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Chapter 13 
Job Management 



This chapter describes the DCL commands that you use to manage RSTS/E 
jobs. Table 13-1 summarizes these commands. The rest of this chapter 
explains the commands in detail and gives examples of their use. 



Table 13-1: DCL Commands for Job Management 

+ + + 

| Command | Description | 



ATTACH 


| Attaches a terminal to a job. 


BROADCAST 


| Displays a message at the specified 
| destination( s ) . 


DETACH 


| Detaches a job from its terminal. 


FORCE 


| Forces a "string" to the specified 
| destination( s ) . 


HANGUP 


| Disconnects the specified remote line. 


LOGIN 


| Creates a job at the specified terminal, logs 
| your current job in under a different 
| account, or resets your current job to its 
| initial logged-in state. 


REMOVE/JOB 


j Immediately terminates the specified user job 
| and logs it off. 


SET JOB 


| Defines the characteristics of a job. 


SET SYSTEM 


| Sets the default system characteristics. 


SHOW JOB/PRIVILEGE 


| Displays the set of current privileges for 
| the current job. 
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Controlling the Number of Logged-In Jobs 

You can monitor and control system operation while logged in to a 
RSTS/E system, with the SYSTAT or the DISPLY system program, you can 
observe how the system is performing. If performance declines, you 
can remedy the problem, in some cases, by preventing more users from 
logging in to the system. You adjust the number of logged-in jobs 
allowed with the SET SYSTEM/LOGINS, and SET SYSTEM/NOLOGINS commands. 

SET SYSTEM/NOLOGINS sets to one the number of jobs that are allowed to 
log in to the system. After RSTS/E executes the SET SYSTEM/NOLOGINS 
command, the system allows no more users to log in to the system. If 
a user attempts to log in or to execute a logged-out command, the 
monitor prints the following error message: 

?No logins 

Jobs already logged in to the system can continue running. However, 
jobs such as BATCH that create logged in jobs cannot successfully 
process further requests. (The SHUTUP system program also disables 
further logins in preparing to shut down timesharing.) 

To keep you from being locked out of the system, RSTS/E allows jobs to 
be logged in at the system console terminal ( KBO : ) , regardless of the 
number of logins currently allowed. (This feature is a special 
characteristic of the terminal you designate as the system console; 
the default is KBO:. By installing a feature patch, you can change 
the terminal which has this characteristic. However, only one 
terminal on a system can have this capability.) This capability 
remains in effect as long as a job slot is available to handle a new 
job. You need SWCTL privilege to use the SET SYSTEM/NOLOGINS command. 

The SET SYSTEM/LOGINS command places a ceiling on the number of users 
that can log in to the system. This command is useful for limiting or 
extending the load allowed on the system. For example: 

$ SET SYSTEM/LOGINS=35 
$ 

This command limits the number of logins to 35; if there are 35 or 
more users logged in to the system, the next user who tries to log in 
gets the error message ?No logins and must wait until enough users log 
off before being allowed to log in. 

The system does not let you set the number of logins to zero or to a 
number greater than the value of JOB MAX set at system installation 
time. If you specify zero in the command, RSTS/E sets the number to 
one. The default number is JOB MAX. You need SWCTL privilege to use 
the SET SYSTEM/LOGINS command. 

The number of logins allowed can never exceed the capacity of the swap 
space installed on the system or the value specified during system 
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generation. If you enter a number greater than the maximum allowed, 
RSTS/E sets logins to the maximum possible. The free buffer status 
report of SYSTAT or the DISPLY program includes the maximum number of 
logins currently allowed. 

You normally use the SET SYSTEM/LOGINS command with the 
INSTALL/SWAP_FILE command to adjust the number of logins allowed. 
After you add swap space to the system, the SET SYSTEM/LOGINS command 
performs these steps: 

1. Recalculates the swap capacity 

2. Factors in the currently allowed maximum swap size (SWAP MAX) 

3. Increases the number of allowed logins 

If you are preparing to remove swap space, use the SET SYSTEM/LOGINS 
command to decrease the number of allowed logins. 



Broadcasting Messages to Terminals 

The BROADCAST command lets you communicate with one user or with all 
users on the system. You need SEND privilege to execute the BROADCAST 
command. This command places a specified text string in the output 
buffer of a terminal, or of all terminals, and displays the text on 
the terminal. For example, if a user at terminal KB32: assigns a 
peripheral device for an unreasonably long time, you can send a 
message asking the user to deassign the device: 

$ BROADCAST KB32 : "Bob, can you deassign MMO : for me; I need it 
ASAP . 11 
$ 

By specifying /LOGGED__IN instead of a terminal designator, you can 
broadcast the message to each online terminal in the RSTS/E system 
(unless the terminal is set for NOBROADCAST) . For example: 

$ BROADCAST/LOGGED_IN "Read $NOTICE.TXT; the system is coming 
down! ! " 
$ 

The system displays your message as follows: 

*** From [1,214] "Account Name" on KB25: at 02:17 PM 27-May-85 
** Read $NOTICE.TXT; the system is coming down I I 

. i 

This message appears on all terminals that are on line and set to 
BROADCAST, except your own. 
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You can direct your message to specific users by substituting a PPN 
for the destination specification. Wildcard characters are also 
permissible. For example, to broadcast a message to all users logged 
in under the same project number: 

$ BROADCAST [20,*] "Please attend a meeting at 3:00 PM today" 

You can send a multiline message with BROADCAST as follows: 

1. Press RETURN after the destination specification. RSTS/E 
displays the prompt Message: on your terminal. 

2. Enter your message, terminate each line by pressing RETURN. 

3. Enter CTRL/Z to send your message. 

In a multiline message, you do not need to enclose the message in 
quotes. For example: 

$ BROADCAST/ALL<RET> 

Message: The power will be shut off in the building this 
weekend . <RET> 

Message: Therefore, this system will be taken down Friday 
night . <RET> 

Message: No logins will be allowed after 5PM on Friday. <RET> 

Message: <CTRL/Z> 

$ 



Controlling Jobs 

The FORCE command lets you send a text string to another terminal (or 
all terminals). You need SYSIO privilege to use the FORCE command. 
The system places the text string in the input buffer of the specified 
terminal as if it were typed by the user. The command has the format: 

FORCE destination "command" 

If you want to send a CTRL/C to a terminal, KB32 in this case, to stop 
the execution of whatever is running at the terminal and then to log 
the user off the system, type: 

$ FORCE KB32: ""LOGOUT" 
$ 

The circumflex (" ) character before the command forces a CTRL/C to the 
terminal, and the LOGOUT command logs the user off the system. 
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You can also send only a CTRL/C (~C) to a terminal by placing a 
circumflex character in the first position after the keyboard number. 
For example: 

$ FORCE KB32 : " 
§ 

Do not place any text after the circumflex if you want to send only a 
CTRL/C to the terminal to stop the job that is running. RSTS/E sends 
a CTRL/C to the terminal and returns control to the keyboard monitor 
prompt. For example: 

~C 
$ 

To force a control character combination ( CTRL/Z for example) to a 
terminal, enter the circumflex (~ ) character as the first character of 
the text, followed by the proper control letter (such as Z). For 
example : 

§ FORCE KB32: "~Z" 
$ 

Typing "z and pressing RETURN executes a CTRL/Z at KB32: No other 
text should follow the control character combination. If the 
circumflex C ) is the first character of more than two characters of 
text, however, RSTS/E forces a CTRL/C to the terminal before sending 
the text that immediately follows the first character. For example: 

$ FORCE KB32: ""IHarry, sorry but your job is out of control!" 
$ 

The "C characters appear on Harry's terminal to end the job he was 
running and the system prints the text of the message on the following 
line. (The text after the first character can contain up to 80 
characters . ) 



Removing Jobs 

The REMOVE/JOB command lets you terminate a user's job and remove it 
from the system. You need JOBCTL privilege to use the REMOVE/JOB 
command. Before using REMOVE/JOB, use the SHOW USER command to learn 
the user's job number, then type: 

$ REMOVE/JOB 10 
$ 

The monitor clears job 10 and frees it for other system use. The user 
is no longer logged in to the system and must log in again before 
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attempting any other system activity. Use the SHOW USER command 
immediately after issuing the REMOVE/JOB command to verify that the 
job is no longer on the system. 



Placing a Job on HOLD 

There are times when you do not want to terminate a job, but rather 
want to place it in a hold state, a state from which it can resume 
normal processing. A job may be using up too many system resources, 
or you may be running a batch job that you need to correct. The SET 
JOB/HOLD command automatically sets the priority of a job to -128. 
This causes the system to stop giving the job any time to run. Use 
the SET JOB/HOLD command as follows: 

$ SET JOB/HOLD 10 
$ 

Job 10 stops processing but does not terminate. SET JOB/HOLD always 
sets the priority to -128, which means you cannot include a priority 
number with the command. You must reset the priority of the job to 
-120 or higher with the SET JOB/RELEASE command to reactivate the job. 
Use the SET JOB/RELEASE command as follows when you want to restart 
the job: 

$ SET JOB/RELEASE 10 
$ 

Now job 10 has the default priority of -8, which under normal system 
load allows the job to successfully run to completion. 

SET JOB/HOLD and SET JOB/RELEASE are the logical commands to use when 
you want to stop a job temporarily and then start it again. You need 
TUNE privilege to use the SET JOB/HOLD or the SET JOB/RELEASE 
commands. 



Setting Job Priority, Run Burst, and Maximum Size 

The system lets you set the priority, run burst, and maximum size of 
an existing job. You can change any of the current values to: 

o Increase or decrease the chance of gaining run time in 
relation to other running jobs 

o Determine how much CPU time the job can have when it is 
compute bound 

o Increase the area a job can occupy 
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The system runs jobs on the basis of priority. The higher a job's 
priority, the better its chances of obtaining run time in relation to 
other jobs that are running. Figure 13-1 shows how an 8-bit priority 
byte determines priority. 



xxxxxxxx 

Sign User -Definable System-Definable 

Bit Portion Portion 



Figure 13-1: Priority Byte Format 



Using the SET JOB/PRIORITY command, you or another user can set the 
user -definable portion of the priority byte for any job on the system. 
Because the three system-definable bits are normally zero, standard 
priorities are multiples of 8 between -120 (lowest priority) and +120 
(highest priority). Zero is a legal priority. When the system 
changes a priority, it truncates any value not a multiple of eight to 
the next lowest legal priority. For example, if you specify a 
priority of +10, RST/E sets the value to +8. 

You need TUNE privilege to use the SET JOB/PRIORITY command. 

All of the system-definable bits are normally off (zero). The least 
significant bit is set when a keyboard delimiter is typed and the job 
is waiting for keyboard input or when any I/O completes. Keyboard 
delimiters are Carriage Return (CR), Line Feed (LF), Form Feed (FF), 
Control z (CTRL/Z), and Escape Sequence Character (ESC). The next 
significant bit is set whenever a CTRL/C is entered and can be set at 
any time. Finally, a system function call sets the most significant 
bit of the system-definable portion. RSTS/E clears all 
system-definable bits when it chains to another program or when the 
job is at the system command level. 

The system-definable portion of the priority byte is always less 
significant than the user -definable portion. Therefore, the 
system-definable bits affect priority only within the user -definable 
priority range. For example, if two jobs are running under priority 
-8, the user who enters a CTRL/C has a higher priority (that is, 
priority -6 in this case) than the user who does not. However, a 
third user with priority supersedes two users whose priorities are 
-8 and -6. 

When you log in, LOGIN runs with priority and automatically sets 
your job to priority -8. This is the default priority with which most 
or all jobs are run. Do not assign priorities other than -8 except in 
unusual circumstances (for example, compute-bound or detached jobs). 
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On occasion, you may want to run a program that requires a great deal 
of computation. If time is not a factor in obtaining results, and you 
have TUNE privilege, you can decrease the job priority of the 
compute -bound job to improve efficiency for the other users on the 
system. On the other hand, infrequently used detached programs often 
have higher priorities (typically priority 0) because they must run 
quickly when needed but do not run compute bound for an extended 
period and do not run often. 

Run burst is the maximum time a job can run compute bound before 
another job obtains access to the CPU. On systems using the KWllL 
line frequency clock, each unit of run-burst time is equal to l/60th 
or l/50th of a second, depending on the system's power line frequency. 
Systems running with the KW11P clock at crystal speeds, rather than at 
line frequency, have a run-burst unit of l/50th of a second. If the 
system is operating from a 60 Hz power line, one run-burst unit equals 
l/60th of a second. In that case, six units equal l/10th of a second, 
which is the run-burst default value. 

If you assign a run burst of six to a specific job that does not 
require much compute -bound time, the system automatically transfers 
control to the next user before the six units have been used. One 
tenth of a second is generally considered the best run-burst time 
period to ensure efficient overall system operation. If a job is 
guaranteed to become I/O bound (that is, I/O stalled) after a certain 
amount of computation, use SET JOB/RUN_BURST to specify a run burst 
larger than six. In many cases, a run burst greater than six has a 
significant effect on long computational programs. Their percentage 
of the overall CPU time would be increased. 

You need TUNE privilege to use the SET JOB/RUN__BURST command. 

The maximum size assigned to a job refers to the allowable memory 
space. You can let certain jobs run programs larger than 16K words by 
assigning a job a maximum size up to 32K words (64K words for systems 
with I/D space). This assigned limit does not affect privileged, 
compiled programs. Thus, a user with a small amount of space can 
still run system programs that would normally exceed the memory limit. 
To alter the maximum job size of job 14, use the SET JOB/SIZE command 
as follows: 

$ SET JOB/SIZE=32 14 
You need the TUNE privilege to use the SET JOB/SIZE command. 
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Controlling Keyboards and Remote Lines 

If you determine that a dataset line is in use but no keyboard 
activity is taking place (by using SYSTAT or the DISPLY program job 
status report), you can disconnect the dataset. The HANGUP command 
disconnects the remote line specified by the KBn : keyboard. The 
hangup capability prevents a user from monopolizing the line without 
being charged for connect time and frees the line for other remote 
users. You need HWCTL privilege to use the HANGUP command. 

The DETACH command frees a terminal from its job. If the job does not 
have the terminal open on a nonzero channel, DETACH frees the terminal 
for other use. The command normally forces the system to close all 
nonzero channels on which the terminal is open. The /NOCLOSE switch 
suppresses this action. When the job specified is currently detached, 
the monitor prints the error message: 

?Job number x is already detached. 

You need JOBCTL privilege to use the DETACH command (except for your 
current job) . 



DCL Command Descriptions 

The following sections describe the DCL commands that you can use for 
job management. 
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ATTACH Command 

The ATTACH command attaches a terminal to a job. This command does 
not require any privileges. 

+ + 

I Format j 

| ATTACH n | 

j Prompts j 

I Job number : | 
+ + 

Command Parameters 
n 

The number of the job you want to attach to. 
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BROADCAST Command 

The BROADCAST command sends a message to: 
o A specified terminal ( KBn : ) 

o All users logged in under a specified PPN (the PPN can 
contain wildcard characters) 



Note 

This command displays a message only on terminals 
that are not set to NOBROADCAST. 

You need SEND privilege to use BROADCAST. 



Format 

BROADCAST destination ["message"] 

Command Qualifiers Defaults 

/ALL 

/[NO] BELL /NOBELL 
/[NO] HEADER /HEADER 
/LOGGED_IN 

Prompts 

To : 

Message : 



Command Parameters 



destination 



The device(s) where the message is to be displayed, 
"message" 

The message to be displayed on the destination device(s). If you 
type RETURN after entering the destination specification, DCL 
prompts you for each line of a message. Enter CTRL/Z to send the 
message. Note that when you enter a multi-line message in this 
way, do not enclose the message in quotes. 
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Command Qualifiers 
/ALL 

Broadcasts the message to all terminals. 
/[NO ] BELL 

Broadcasts a BELL character before the message. The default is 
/NOBELL. 

/[NO] HEADER 

Broadcasts a header before the message. The header is in the 
format : 

From ARK:: [1,194] "Account Name" on KB52: at 11:52 AM 30-May-85 
The default is /HEADER. 
/LOGGED_IN 

Broadcasts the message to all logged-in terminals. 
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DETACH Command 

The DETACH command detaches a job from its terminal. You need JOBCTL 
privilege to detach any job other than your current job. 



Format 
DETACH n 

Command Qualifiers 
/[NO]CLOSE 
Prompts 
Job number: 



Defaults 

/CLOSE 



Command Parameters 



n 



The number of the job you want to detach from its terminal. 
Command Qualifiers 
/[NO] CLOSE 

Indicates whether the system closes all nonzero channels on which 
the job's terminal is open before detaching. The default is 
/CLOSE. 
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FORCE Command 

The FORCE command forces a string to: 
o A specified terminal 

o All users logged in under a specified PPN. 
contain wildcards. 

You need SYSIO privilege to use FORCE. 



The PPN can 



+ - 



+ 



Format 

FORCE destination "string" 

Command Qualifiers Defaults 
/ALL 

/LOGGED_IN 
Prompts 
To : 

Command : 

+ - + 

Command Parameters 
destination 

The device(s) that you want the "string" forced to. 
"string" 

The string that you want forced to the destination device(s) 
Command Qualifiers 
/ALL 

Forces the string to all terminals. 
/LOGGED_IN 

Forces the string to all logged-in terminals. 
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HANGUP Command 

The HANGUP command disconnects the specified remote line. You need 
HWCTL privilege to use HANGUP. 

+ + 

| Format | 

| HANGUP KBn: | 

I Prompts j 

I Keyboard: | 
+ + 

Command Parameters 

KBn: 

Specifies the remote line you want to disconnect. 
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LOGIN Command 



The LOGIN command is used to: 



o Create a new job at the specified terminal. You can use this 
feature in your system start-up procedure to log in various 
users automatically. You need WACNT or GACNT privilege to 
create a new job. If the terminal is restricted, you also 
need DEVICE privilege. 

o Log your current job in under a different account. This 
feature lets you switch between accounts without having to 
first issue the LOGOUT command (see RSTS/E System User's 
Guide). You need WACNT or GACNT privilege to log in to a 
different account without being prompted for that account's 
password . 



o Reset your current job to its initial logged-in state (the 
state your job was in after logging in). This feature is 
useful for resetting logical assignments, DCL symbols, 
prompts, and so on to their initial state. This feature does 
not require any privilege. 



+ 



- + 



Format 

LOGIN [p,pn] 

Command Qualifiers 

/[ NO ] OVERRIDE [ =NOLOGINS ] 
/TERMINAL=terminal[ : ] 

Prompts 

Password: 
+ 



Defaults 

/NOOVERRIDE 
Your terminal 



— + 



Command Parameters 



IP/Pn] 



The PPN for the account you want to log in to. The default PPN 
is your PPN. 
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Command Qualifiers 

/OVERRIDE [ =NOLOGINS ] 
/NOOVERRIDE 

Indicates whether to create the new job if logins are currently 
disabled. Specify /OVERRIDE or /OVERRIDE=NOLOGINS to create the 
new job even if logins are disabled. If you attempt to create a 
new job with the /NOOVERRIDE qualifier and logins are disabled, 
the monitor displays an error message. The default is 
/NOOVERRIDE. 

The /OVERRIDE qualifier requires that you also specify the 
/TERMINAL qualifier. 

NOTE 

Even with /OVERRIDE in effect, you cannot create 
a new job unless there are job slots available on 
the system. 

/TERMINAL=terminal [ : ] 

Indicates that a new job should be created at the specified 
terminal. The terminal argument can be any valid device name 
that refers to a keyboard device. If the terminal you specify is 
restricted, you must have DEVICE privilege. You must have WACNT 
or GACNT to log in to another account on the specified terminal. 

Examples 

The following examples show the different features of LOGIN. To reset 
your job to its initial logged-in state, enter: 

§ LOGIN 

To log in to account [10,10] after you correctly supply the password 
for that account: 

$ LOGIN [10,10] 
Password : 

If you have WACNT or GACNT privilege and you are switching from any 
[10,*] account, the monitor does not prompt you for the password. 

To log in user [100,3] at terminal KBll: enter the following: 

$ LOGIN/TERMINAL=__KBll : [100,3] 

You must have WACNT privilege, or have GACNT privilege and be logged 
in to [100,*] account to execute the previous command. 
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REMOVE/JOB Command 

The REMOVE/JOB command immediately terminates the specified user 
and logs it out. You need JOBCTL privilege to use this command. 

+ . . . . + 

j Format j 

| REMOVE/JOB n | 

j Prompts j 

| Job number: j 
+ + 

Command Parameters 

n 

Specifies the job to remove. 
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SET JOB Command 

The SET JOB command defines the characteristics of the specified job 
The /KEYBOARD_MONITOR and /PRIVILEGE qualifiers can only be used for 
the current job. If you specify those qualifiers with a job number 
other than your own, RSTS/E displays the following error message: 

?Only current job allowed. 

You need TUNE privilege to use any of the qualifiers except 
/KE YBOARD_MON I TOR and /PRIVILEGE. 



Format 
SET JOB n 

Command Qualifiers 
/HOLD 

/KEYBOARD__MONITOR[ =name ] 
/PRIORITY=p 

/PRIVILEGE=(priv,priv, . . . ) 

/RELEASE 

/RUN_BURST=q 

/SIZE=q 

Prompts 

None 



Defaults 
No change 



Command Parameters 



n 



Specifies the job whose characteristics you want to define. 



SET JOB 



Command Qualifiers 
/HOLD 

Sets the priority of job n to -128. This qualifier cannot be 
used for the current job. 

/KEYBOARD__MONITOR[=name] 

Sets the current job's keyboard monitor to name. The allowable 
values of name are any installed run-time system that has a 
keyboard monitor. Use the SHOW RUNTIME_SYSTEM command to list 
the run- time systems on your system. If you omit the optional 
argument, the system default keyboard monitor becomes the current 
job's keyboard monitor. 

/PRIORITY=p 

Sets the priority of the specified job. Priority can be any 
number from -128 to +120. The system rounds the priority down to 
a multiple of eight. (For example, if you select a priority of 
-19, the system sets the priority to -24.) 

r 

/PRIVILEGE=(priv,priv, . . . ) 

Modifies the set of current privileges for the current job only. 
/RELEASE 

Resumes job n at priority of -8. 
/RUN_BURST=q 

Changes the run burst of the specified job to q. The value for q 
can be any number from 1 to 127. 

/SIZE=q 

Changes the maximum size of the specified job to q. You can set 
q to a maximum of 32K. 
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SET SYSTEM Command 



The SET SYSTEM command sets the default system characteristics, 
need SWCTL privilege to use the SET SYSTEM command. 



You 



Format 

SET SYSTEM 

Command Qualifiers 

/[ NO] LOGINS [=n] 

Prompts 

None 



Defaults 

See Discussion 



Command Qualifiers 
/[ NO] LOGINS [=n] 

Defines the maximum number of users who can log in to the system 
at one time. Set /LOGINS=n to the number of user jobs that can 
log in to the system at one time. The default is JOB MAX. 
Specify /NOLOGINS if you want to prevent users from logging in to 
the system by setting the number of logins to one. 



See Chapter 14 for additional SET SYSTEM command qualifiers. 
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SHOW JOB/PRIVILEGE Command 

The SHOW JOB/PRIVILEGE command displays the set of current privileges 
for the specified job. You need JOBCTL privilege to display the 
privileges of another job. 



Format 

SHOW JOB/PRIVILEGE [n] 
Prompts 
None 

Command Parameters 
[n] 

Specifies the job whose current privileges you want to display 
The default is the current job. 
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Chapter 14 

Miscellaneous System Management Functions 



This chapter describes miscellaneous DCL commands that you use to 
manage your RSTS/E system. Table 14-1 summarizes the DCL commands 
available to you. The rest of this chapter explains each command in 
more detail. 



Table 14-1: DCL Commands for Miscellaneous System Functions 



Command | Description 



LOAD/OVERLAY 


■ + 

| Loads one or more monitor overlays in memory. 


SET DATE 


| Sets the RSTS/E system date to the value you 

| specify. Optionally, you can specify a new value 

| for the system time. 


SET SYSTEM 


| Sets the default system characteristics. 


SET TIME 


| Sets the RSTS/E 24 -hour clock to the value you 
! specify. Optionally, you can set the system date 
| to the value you specify. 


SHOW SYSTEM 


| Displays the system-default characteristics. 


UNLOAD/OVERLAY 


| Unloads one or more monitor overlays from memory. 



Loading and Unloading Monitor Overlays 

The LOAD/OVERLAY and UNLOAD/OVERLAY commands let you load and unload 
monitor overlays during timesharing. You can use these commands in 
conjunction with the DISPLY program and the SHOW CACHE command to 
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monitor the effects on your system's performance of making certain 
overlays resident or nonresident. 

The monitor overlays that you can specify with these commands are: 

o ATTRIBUTE Performs file and account attribute read/write 
operations 

o DCL -- Performs file- related operations for DCL 

o DELETE_RENAME -- Performs file deletion and renaming 

o DIRECTORY -- Performs disk file lookup operations 

o SYSTEM__CALLS Performs specific monitor directives 

o TERMINAL -- Performs terminal attribute read/write operations 



Suspending System Operations 



The SET SYSTEM/HOLD and SET SYSTEM/RELEASE commands let you 
temporarily suspend all disk I/O and other system operations. When 
you issue the SET SYSTEM/HOLD command, all jobs on the system are 
suspended, except for the job issuing the command. Operations resume 
when you issue the SET SYSTEM/RELEASE command. 

The SET SYSTEM/HOLD and SET SYSTEM/RELEASE commands are used primarily 
on systems where the system disk is an RC25. The main reason for 
using these commands is to suspend operations when you need to stop 
the fixed disk drive so you can mount a different disk cartridge (both 
disks share the same spindle). With SET SYSTEM/HOLD and SET 
SYSTEM/RELEASE, a total system shutdown is not necessary. You need 
HWCTL privilege to use the SET SYSTEM/HOLD and SET SYSTEM/RELEASE 
commands. To use the commands, type: 



$ SET SYSTEM/HOLD 
System now on hold 
$ 



The system displays the message System now on hold to show that the 
suspend is in effect. When the disk stops, you can change the 
removable cartridge. When you are ready to resume system operations, 
type : 

$ SET SYSTEM/RELEASE 
System released 



$ 
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Changing System Date and Time 

The SET DATE and SET TIME commands let you change the system date and 
the 24 -hour clock. These commands are important on systems where 
strict accounting data is kept and incorrect values may have been 
entered at system start-up time. You can enter the date in either of 
two formats: 

SET DATE dd-mmm-yy 
SET DATE yy.mm.dd 

The following example shows how to enter the date using the first 
format : 

$ SET DATE 30 -MAY- 85 

You can enter the same date in the second format as well: 
$ SET DATE 85.05.30 

Be sure to place a space between the DATE command and the beginning of 
the date field when entering a date with either format. You need 
DATES privilege to use the SET DATE or SET TIME command. 

You can enter the time in either of two formats: 

SET TIME 01:30PM 
SET TIME 13:30 

You change the date and/or the time with either command as follows: 
For SET DATE; 

$ SET DATE 3 -MAY- 85 

$ SET DATE 30 -MAY- 85 :01:30PM 

For SET TIME; 

$ SET TIME 01:30PM 

$ SET TIME 30-MAY-85:01:30PM 

Note that when you specify both parameters, you must first enter the 
date and separate the two parameters with a colon. 

You can also specify a relative date and time with the SET DATE 
command. For example: 

SET DATE - 1DAY 
SET TIME +1HOUR 

The first command, when executed, sets the system date back a day. 
The second command, when executed, adjust the system time ahead one 
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hour. You can use relative values to make minor adjustments in the 
system date or time. Relative date and time syntax is as follows: 

+nnDAYS 

+nnHOURS 

+nnMINUTES 

You can string the keywords together in any order and you can 
abbreviate them to one character. If you specify an absolute date and 
time, it must appear first in the date-time specification. An example 
of mixed absolute and relative date and time would be: 

SET DATE 10-MAY-85:4:00PM+3DAYS+2HOURS-45MINUTES 

This would be equivalent to: 

SET DATE 13-MAY-85:5:15PM 



Recording System Activities: EMT Logging 

An EMT is a PDP-11 assembly language instruction through which a 
program requests services from the monitor (for example, opening and 
closing a file, performing I/O, and logging in or out.) EMT logging is 
an optional feature that provides a "window" on the process by which 
timesharing jobs request and receive services from the RSTS/E monitor. 
Thus, EMT logging lets you gather information about the activity on 
your system. 

For example, you might want to know the following information about 
your system: 

o The number of logins on a particular terminal 

o How many files are accessed on a certain drive 

o Which nonresident FIP overlays get the heaviest use 

Such information can help you improve system performance, identify 
bottlenecks, establish fee setting algorithms, and watch for potential 
security problems. 

This section describes the EMT logging feature, how it works, and how 
to include it in your system. However, because of the wide variety of 
RSTS/E systems, you must decide which data is most useful in your 
environment, and how to collect and use the data the EMT logger 
provides . 

EMT logging includes optional code in the monitor, uses XBUF to pass 
information, and requires an EMT logging program (which you must 
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supply), running as a timesharing job. The use of EMT logging can 
affect performance. This effect depends on which EMTs you decide to 
log, for which jobs you log them, and how much processing your logging 
program does for each EMT. 

EMT logging provides information on timesharing activity in terms of 
what the monitor sees. The data returned to your logging program is 
in terms of FIRQB and XRB contents, regardless of the programming 
environment of the job that issues the directives. See the RSTS/E 
System Directives Manual for information on the FIRQB and XRB, as well 
as descriptions of the MACRO form of system directives. 



Programming for the EMT Logger 

To use EMT logging, you must: 

o Include optional code in your monitor at system installation 
time. 

o Supply a program to process the data extracted by the monitor 
code. This program retrieves extracted data by send/receive 
calls. 

During the system installation dialogue, RSTS/E asks you: EMT 
Logging?. Answer YES to create a monitor that can extract EMT 
information and pass it to your program. 

Your logging program is a normal time-sharing job. You can design the 
program to do such activities as: 

o Select pertinent data 

o Maintain a log file 

o Signal events on one or more terminals 

o Control your system while it is running 

RSTS/E never logs EMTs for certain jobs, including the Error Logger 
(ERRCPY) and your EMT logging program itself; in addition the monitor 
does not allow you to log certain EMTs. 



How EMT Logging Works 

If EMT logging is available and active, the monitor inspects each EMT 
as it is received. ("Available" means installed in the system; 
"active" means that your EMT logging program has properly declared 
itself as a receiver.) If the newly- received EMT is one that RSTS/E 
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logs, the monitor builds a packet of information about the directive 
and stores the packet in XBUF. Note that EMT logging does not use 
small buffers for message transfer. 

The packet contains: 

o Context data, such as date and time, user job number, and 
keyboard number 

o Directive data, such as information from the job's FIRQB 
and/or XRB 

When the directive is complete, additional information (for example, 
the RSTS/E error code) is added to the packet. The packet is then 
made available to your program. Your program can inspect the 
parameters passed from the user's job to the monitor, determine the 
relevance of the directive being logged from the packet, and take the 
appropriate action. 

Your program retrieves EMT logging packets by issuing message receive 
calls. Parameters in the declare receiver call of your program 
speci f y : 

o How many packets constitute a message 

o How many packets can be outstanding at any time 

o How much XBUF the EMT logger can use 

Each message received by your logging program consists of the packets 
(one per selected EMT) plus control information. This control 
information includes a count of EMTs that may have been lost because 
one or more of the limits you set up at declare time has been 
exceeded. 

See the RSTS/E Programming Manual for a description of the use of 
message send/receive calls as well as specific information about the 
send/receive calls used for EMT logging. 



Data Returned by EMT Logging 

The meaning of the data returned by the logging program you write 
depends on the internal functioning of the monitor. For this reason, 
both the format and meaning of data returned are subject to change in 
future releases of RSTS/E. DIGITAL reserves the right to change 
internal mechanisms and, therefore, makes no commitment to continue 
providing any specific part of the data described for this release of 
RSTS/E. 
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EMT Logging and System Security 

The information that EMT logging provides may be helpful in checking 
and maintaining system security. However, the use of EMT logging as a 
system security tool depends on many si te - specif ic factors: 

o The types of events that can be watched for 

o The degree of security required 

o The way that EMT logging is set up 

o The experience and judgment of the system manager who sets up 
EMT logging and interprets its data 

o The general security practices of the site 

In summary, although EMT logging does not guarantee improved system 
security, it can provide a very useful tracking mechanism. 



Monitoring System Status: SYSTAT 

During normal timesharing, there are many occasions when you need to 
monitor the status of your system. RSTS/E provides two system 
programs for this purpose: 

DISPLY Automatically displays system status information on your 
terminal. By default, the program displays the system 
status every 15 seconds; however, you can specify a 
different interval. See the following section for a 
description of the DISPLY program. 

SYSTAT Displays the status of different parts of the system when 

you use various program switches. See the RSTS/E Utilities 
Reference Manual for a complete description of SYSTAT and 
the switches associated with it. 

The description of SYSTAT in this section gives a set of guidelines 
for using the SYSTAT program for more effective system management. 
Use SYSTAT to: 

o Prepare for system shut-down to learn what jobs are active 
and which disk devices and assignable devices are in use. 

o Determine when the number of general small buffers becomes 
too low. You can then decide whether to use the DCL commands 
SET SYSTEM/NOLOGINS and SET SYSTEM/LOGINS to restrict the 
number of users that can log in to the system. Note that you 
can also use the SHOW BUFFERS command to display the number 
of available general small buffers. 
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o Check on the amount of free disk space. The disk status 

report in SYSTAT reflects the apparent number of free blocks 
on each disk on the system. For practical purposes, however, 
such as for allocating a file on the device, all free blocks 
that SYSTAT reports may not be usable. You may get the 
message ?No room for user on device when SYSTAT reports there 
are free blocks available. Note that you can also use the 
SHOW DISKS command to display the amount of free disk space. 

The file cluster size or the number of clusters you need can 
prevent a file from fitting on a device. For example, a file 
whose cluster size is 16 and whose length is 10 blocks may 
not fit on a device that SYSTAT reports to have 50 free 
blocks of file space remaining. The cluster size of 16 
demands that 16 contiguous blocks of free space exist on the 
device before the file can be allocated to the device. In 
some cases, 16 contiguous blocks do not exist on a device and 
RSTS/E does not allow a file to extend to another physical 
device even though SYSTAT can give you some indication of the 
availability of free disk space. 

o Follow the progress of user jobs. You can determine if a job 
is stalled, waiting for resources on your system. If you 
notice that a run-time value of a job is not increasing (the 
value is printed in a job status report), it indicates that 
the job is stalled and waiting for an I/O device. One user 
job can allocate a device or keep an assignable device locked 
by having one file open. You can determine who the user is 
by examining the device status report that associates the 
busy device with the job number of the user controlling that 
device. You can then ask the user to free the device or, if 
that is not possible, you can use DCL commands to force the 
job off the system (FORCE) or seize the device 
(ALLOCATE/SEIZE). Note that you can also use the SHOW USERS 
and SHOW JOBS commands to display user job status. 

o Follow the progress of detached jobs. When SYSTAT reports a 
detached job in the HB (hibernate) state, you know the 
detached job is attempting to communicate with its terminal. 
In this case, log in to the system at a free terminal, and 
then use the ATTACH command to attach the job to the 
terminal. Once you attach to the detached job, RSTS/E can 
display the messages from the job. Note that you can also 
use the SHOW JOBS/DETACHED command to display the status of 
detached jobs. 

o Check on the number of jobs on the system. The free status 
report lists the number of jobs currently logged in to the 
system and the maximum number of jobs allowed. These numbers 
are useful when you are adding and removing swap files. 
After adding the swap files and raising the logins allowed, 
you can check the free status report to confirm the success 



14-8 



Miscellaneous System Management Functions 



of the procedure. Before removing a swap file, check this 
report to make sure that the number of logins allowed is low 
enough to enable you to remove the swap file at some later 
time. Note that you can also use the SHOW SYSTEM command to 
display the number of jobs on the system. 



Dynamic Display of System Status: DISPLY 

The DISPLY system program displays the system status on VT52, VT100, 
and VT200 series terminals. After you start the program and decide 
how frequently you want it to update the system status on the screen, 
the program runs until you interrupt its execution. The information 
DISPLY prints is similar to that of the SYSTAT program. Commands you 
type during the execution of the program can alter the information 
displayed on the screen. These commands let you choose only those 
portions of the system status you need to see. 

The program resides in the AUXLIB$: account with the protection code 
of <232>. This protection code lets all users run the program. If 
you want to restrict running the SYSTAT program to users that have the 
same project number as the owner, change the protection code to <120>. 



Running the DISPLY Program 

The program prints an identification line and a question after you 
type the command line RUN AUXLIB$ : DISPLY . They appear as follows: 

$ RUN AUXLIB$ : DISPLY 
DISPLY V9.0 RSTS V9 . EDERE 
Interval? 

If you want updates to occur every 15 seconds, press RETURN to accept 
the default. Otherwise, type the number of seconds you want to elapse 
between screen updates. You can include any combination of the 
switches in Table 14-2 in your response. If you select a program 
switch but do not specify an interval, the program again assumes the 
default and updates the screen every 15 seconds. Table 14-2 lists the 
DISPLY program switches. 
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Table 14-2: DISPLY Program Switches 



Switch 



Meaning 



+ 



/[NO]DCA 

/DET 
/ECHO * 



/KBn 



/n 



/PRIORITY 

/[NO] TAB 
+ 



Indicates if the terminal can use direct cursor 
addressing to position the cursor on the screen. By 
default, DISPLY uses /DC A . 

Detaches the job from this terminal or from the 
terminal you specify. 

Indicates that the terminal should use echo control 
features. The program disables echoing while it 
updates the screen and spurious characters do not ruin 
the screen display. By default, DISPLY does not use 
ECHO. 

Prints the output at keyboard unit n if it is 
available. If you specify the /DET switch, the program 
runs detached. 

Specifies the number of lines to display. The value of 
n can range from 12 to 24. By default, DISPLY displays 
24 lines. 

Runs the program at a special priority instead of at 
the normal -8 priority. Requires TUNE privilege. 

Indicates if the terminal can correctly process TAB 
characters. By default, DISPLY uses /TAB. 

+ 



* Echo control is an optional feature of the RSTS/E monitor and 
may not be available on your system. 



+ 



- — + 



When you include the /DET switch in response to the INTERVAL question 
to run the program detached, you interrupt execution and you can use 
the terminal for other work. As soon as you enter CTRL/C to interrupt 
the display, the program prints a message telling you the terminal is 
available. When you release the terminal by logging out, the program 
automatically displays the status information on the screen as if it 
had not been interrupted. 

Use CTRL/C to stop the execution of the DISPLY program. The procedure 
you follow after stopping the program depends on whether you were 
running the program attached or detached. If you are running the 
program attached, entering CTRL/C to end the program returns control 
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to the keyboard monitor. When running the program detached, entering 
CTRL/C causes the program to print the following message before 
terminating : 

The terminal is all yours now 

You must then attach the job running the program to the terminal as 
follows : 

HELLO 1,2 <RET> 
PASSWORD: 

Jobs detached under this account: 

Job What Size State Run-time 

10 DISPLY 16 SL 5.6 
Job number to attach to? <RET> 

$ Continue <Yes>? N<RET> 

When the program attaches to the terminal as a result of the HELLO 
command, it prints the CONTINUE question. Finally, type NO or any 
other string not beginning with Y and press RETURN to terminate the 
program. 

The program displays on your terminal an identification line at the 
top line of the screen, skips a line, and fills the left portion of 
the screen with job status information and the right side with 
information about: 



o 


Busy devices 


o 


Di sks 





Run-time systems 


o 


Message receivers 





Free buffers 





Resident libraries 



After the screen is full, the program moves the cursor to the first 
character on the second line of the screen. The program is then idle, 
waiting to cycle through the display again. 

At the specified interval, the program checks the system tables and 
updates the status information on the screen with any changed data. 
While executing routines to extract update information, the program 
prints the message: 

WORKING... 



RTS 
. . .RSX 
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It leaves the cursor to the right of the message. After the update is 
complete, the cursor returns to its idle position. 

While the cursor is in the idle position, you can type commands to 
modify the contents and arrangement of items on the screen. You can 
end any command by pressing the ESCAPE key. Although any line 
terminator works, ESCAPE leaves the cursor positioned on the blank 
line. The program prints no message or takes no action on invalid 
statements . 

Some commands that add items to the screen take the minus (-) sign as 
a prefix. A command with a minus sign preceeding it causes DISPLY to 
delete rather than add a display of the information that would 
normally appear without the minus sign. That is, the minus sign 
negates the effect of the command. 

Table 14-3 lists the commands you use (usually while the cursor is in 
its idle position) to delete or add system status information. 



Table 14-3: DISPLY Program Commands 

+ + + 

| Command Type | Format and Description | 





+ 


General 


c 




| Clears the screen and displays new status. 




Sn 




| Displays memory status in place of job 




| status. Starts with the 8K-word section less 




| than or equal to n. If n is not given, starts 




| at the beginning of memory. 




1 J 

| Displays job status in the standard manner. 




| Jn 




| Displays job status starting with active job 




| n+1. Overcomes physical limitation of the 




screen. 




Xn 




| Changes the interval to n seconds. 




| xo 




| Updates the display with an interval of 




seconds (that is, runs continuously) but 




| lowers the priority so that other jobs are 




| not stalled. 



14-12 



Miscellaneous System Management Functions 



Table 14-3: DISPLY Program Commands (Cont.) 



Command Type 



+ 



Format and Description 



Job Status 



Displays total CPU time each job has used. 
The time is displayed as number of hours, 
minutes, seconds, and tenths of seconds under 
the RUN - TIME column. 



+ 

Displays the increment of CPU time each job 
has used since the display program last 
updated the screen. The user can return to 
total CPU time by typing T. 



Displays the amount of CPU time each job has 
used as a percent of the total CPU time 
expended. The user can return to total or 
increment of CPU time by typing, 
respectively, T or +. 



J-D 

Does not display detached jobs. 
J+D 

Includes detached jobs in display. 
JD 

Displays only detached jobs. 
J-S 

Does not display sleeping jobs. 
J+S 

Includes sleeping jobs in display. 
N 

Indicates the program name in the WHAT 
column . 



-N 

Removes the program name from the WHAT column 
and replaces it with name of the RTS under 
which the job is running. 

P 

Indicates, under the Pr column, the exact 
priority (modulo 8) of the jobs. 
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Table 14-3: DISPLY Program Commands (Cont.) 



Command Type 



Format and Description 



Job Status (Cont.) 



Disk Structure 



Busy Devices 



Free Buffer 



Indicates, under the Pr column, the relative 
priority of the jobs. See the section "Job 
Status Statistics." 

W 

Indicates, under the STATE column, the last 
WAIT state rather than actual state. 

-W 

Removes the last WAIT state and indicates the 
actual state of each job. 

K 

Displays, under the SIZE column, the amount 
of memory occupied by each job. 

-K 

Displays, under the SIZE column, the amount 
of memory remaining for each job. 

D, Dn, -D 

Displays disk structure statistics. If n is 
1, places the item first on the screen. A 
preceding minus sign removes the disk 
structure statistics from the screen. 

L, -L 

Displays, under the COMMENTS column, the 
logical name of each device. The preceding 
minus sign replaces logical names with 
standard PUB, PRI , NFS, or LCK notations. 

B, Bn, - B 

Displays busy device statistics. If n is 1, 
the program places the statistics first on 
the screen. A preceding minus sign removes 
busy device statistics from the screen. 

F , Fn , -F 

Displays free buffer statistics. If n is 1, 
the program places the statistics first on 
the screen. A preceding minus sign removes 
free buffer statistics from the screen. 
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Table 14-3: DISPLY Program Commands (Cont.) 



Command Type 



Format and Description 



Message 



Run-Time System 



Resident Libraries 



M, Mn, -M 

Displays message receiver statistics. If n is 
1, the program places the statistics first on 
the screen. A preceding minus sign removes 
message receiver statistics from screen. 

R , Rn, ~R 

Displays run-time system data. If n is 1, the 
program places the data first on the screen. 
A preceding minus sign removes run-time data 
from the screen. 

H, Hn, -H 

Displays resident library data. If n is 1, 
the program places the data first on the 
screen. A preceeding minus sign removes the 
resident library data from the screen. 



+ 



Screen Layout 

The program divides the screen into four major sections: 

Header line Contains the RSTS/E version number, the name 

of the system, the current date and time of 
day, and the number of hours, minutes, and 
seconds since the start of time-sharing 
operations (termed "up-time"). The header 
line appears on the first line of the 
display. 

Total statistics line Tells the percentage of time that is expended 

by users (User), input and output processing 
(I/O), and the monitor (Exec) as well as the 
amount of idle time (Idle) and lost time 
(Lost). The statistics print on the line 
below the header line but are replaced at the 
interval you specify by the WORKING... 
message. (The statistics are only printed if 
the system was installed with statistics and 
the switch register is set correctly. ) 
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Left-hand portion Contains either the job status statistics or, 

if you use the S command, the memory usage 
status . 

Right-hand portion Contains statistics for busy devices, the 

disk structure, run-time systems, message 
receivers, system buffers, and resident 
libraries . 

The DISPLY program prints information similar to the information 
SYSTAT includes in its status reports. The description of the major 
sections of the dynamic status report includes information about how 
the DISPLY program reports differ from those of the SYSTAT program. 
If you need a more complete description of SYSTAT, see the RSTS/E 
Utilities Reference Manual. 

The following example displays all four divisions. While the example 
does not represent an actual log of the DISPLY program, it does give 
you a picture of how information is displayed. When you run the 
program on your system, not all the illustrated information will fit 
on your terminal screen. You will often need to use commands 
described in Table 14-3 to delete reports so unseen portions of the 
display become visible. The example lets you see an entire display, 
unhindered by screen limitations (usually 24 rows). 
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RSTS V9.0 EDERE Status on 15-May-85 05:31 PM Up: 41:55:19 

6.0%Exec, 10.0%Idle / 1.6%Lost 

Busy Devices 
Dev Job Why Dev Job Why 
PKO 11 A+Op PK1 8 Open 





78.0%User 


5.4%I/0 






Job 


Who 


Whe re 


What Size State 


1 


1 . 2 


De t 


ERRCPY 


5 


SR 




2 


1 . 2 


De t 


OPSRUN 


16 


SL 




3 


1 . 2 


De t 


QUMRUN 


16 


SL 




4 


1,2 


Det 


SPLIDL 


16 


SL 




5 


1,2 


Det 


BATIDL 


13 


SL 


D25 


6 


1,2 


Det 


BATIDL 


13 


SL 


D26 


7 


1,2 


Det 


EVTLOG 


22 


SL 




8 


1,2 


Det 


NPKDVR 


9 


SL 




9 


1,2 


Det 


SYSMAN 


8 


SL 




11 


1,210 


KB32 


ATPK 


8 


SL 




12 


1,210 


P0J11 


DISPLY 


16 


RN 


Lck 


13 


1,223 


KB51 


SYSTAT 


12 


A C 




15 


1,104 


KB31 


. . . EDT 


7 


KB 




16 


1,226 


KB17 


NONAME 


2 


~ C 




20 


1,253 


KB42 


VTEDIT 


14 


KB 




21 


7,214 


KB21 


VTEDIT 


24 


RN 




22 


1,248 


KB29 


PIP 


16 


KB 




23 


226,0 


PUB 


NONAME 


2 


"C 


A09 


24 


1,250 


KB33 


ONLPAT 


15 


KB 




26 


1,243 


KB43 


NONAME 


2 


* C 




27 


1,247 


KB30 


NET 


16 


SL 




28 


8,254 


KB72 


. . .EDT 


7 


HB 





Run-time Pr 
+ 

.8 

3.4 + 



1.8 



Disk Structure 



DK0 1524 


4 


Pri ,R-0 


DR0 19772 


4 


Pri ,DLW 


DR1 43 1720 


4 2 


Pub,DLW 


DR2 12496 


4 


Pri ,R-0 


DR3 9 9720 


8 3 


Pri ,DLW 


DR4 .1 3204 


4 1 


Pri ,DLW 


Run- time 


Systems 


DCL 15K 


9 Prm, 


KBM,CS2 


RT11 4K 


1 Tmp, 


KBM, CZR 


RSX 8K 


Tmp 




BAS4AL 16K 


Non- 


res , KBM 


BASIC 15K 


Tmp,KBM,CSZ 


Message Receivers 


ERRLOG(prv) 


1 


0/40 


OPSER (Loc) 


2 


0/30 


QUEMAN(Loc) 


3 


0/60 


LPOSPL(Prv) 


4 


0/5 


BAlSPL(Prv) 


5 


0/5 


EVTLSN( Prv , Nt ) 


7 


0/16 


EVTLOG (Prv) 


7 1 


0/32 


NWPK08(Nt) 


8 


0/16 


NWTT12 ( Nt ) 


12 


0/5 


Gen FIP Jobs 


TTY 


Err 


315 62 14/50 





3 



Resident Libraries 

Non- res, Rem 
Tmp, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 
Non- res, Rem 



BASICS 


8K 





EDT 


21K 


2 


RMSRES 


4K 


1 


RMSLBA 


4K 





RMSLBB 


4K 


1 


RMSLBC 


3K 





RMSLBD 


2K 





RMSLBE 


4K 





RMSLBF 


4K 





DAPRES 


10K 






Job Status Statistics 

The job status report displays information in eight separate columns 
on the left-hand portion of your terminal. The report is similar to 
the information the SYSTAT program prints in its display of job 
status. Unlike the SYSTAT program, the job status report does not 
include the name of the run-time system under which the job is running 



14-17 



Miscellaneous System Management Functions 



but does include abbreviations indicating the priority of the running 
job. The titles that the DISPLY program prints at the top of a job 
status report have the following meanings: 



Job 



Who 



Where 



What 
Size 
State 

Run- time 



Job number that the system assigns when the job starts 
timesharing activities. 

Account number under which each job runs. If the job 
is not logged in to the system, **,** appears in this 
column . 

Keyboard number of the job. DET appears in place of 
the keyboard number for jobs that run detached from 
the keyboard. The abbreviation PxJy can appear for a 
job running on a pseudo keyboard. The value Px 
identifies pseudo keyboard unit x; and the value Jy 
denotes job number y, under which the controlling job 
is running. 

Program name that the job is executing. 

Current size in K words of the job. 

Current state of the job indicated by the set of 
abbreviations in Table 14-4. 

Hours, minutes, seconds, and tenths of seconds of 
central processor (CPU) time the job has consumed. 



The job status report includes a PR column, which is not displayed by 
SYSTAT, that identifies the priority of the running job. The PR 
column can display the following abbreviations: 

If -P is in effect: 

+ Higher than normal priority 

Lower than normal priority 
S Special run priority 

CTRL/C temporary priority 
K Keyboard delimiter temporary priority 

If P is in effect: 

+n Positive priority n * 8 

Zero priority 

-n Negative priority n * 8 
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Table 14-4 contains a brief description of the abbreviations that can 
appear in the STATE column of the job status report. The following 
status descriptions can appear after one or more of the job state 
abbreviations in Table 14-4: 

Lck Job is locked in memory for the current operation. 

Nsw Job has requested that it not be swapped from memory 

and cannot be swapped unless it requests additional 
memory . 

Swi Job is currently being swapped into memory. 

Swo Job is currently being swapped out of memory. 

Xnn Job is swapped out and occupies slot nn in swap file X; 

file is denoted A, B, C, D to represent files through 
3 of the swap structure. 



Table 14-4: STATE Column Attributes 



Abbreviation 


■ + 

1 


Meaning 


? ? 


■ + 

Job's 


state cannot be determined. 


BF 


| Job is waiting for buffers (no space is available 
| for I/O buffers ) . 




| Job is 
| input. 


in CTRL/C state, awaiting keyboard monitor 


CR 


| Job is 


waiting for card reader input. 


DK,DM,DB,DP, 
DL , DR , DU 


| Job is 


waiting to perform disk I/O. 


DT 


| Job is 


waiting for DECtape I/O. 


DX 


| Job is 


waiting for floppy diskette I/O. 


FP 


| Job is 
| system 


waiting for file processing action by the 
(opening or closing a file, file search). 


HB 


| Job is 
| from a 


detached and waiting to perform I/O to or 
terminal . 


KB 


| Job is 


waiting for input from a terminal. 


LP 


| Job is 


waiting to perform line printer output. 
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Table 14-4: STATE Column Attributes (Cont.) 



Abbreviation 


1 




Meaning 




MT , MM , or MS 




Job 


is waiting for magnetic tape 


I/O. 


PP 




Job is waiting to perform output 
paper tape punch. 


on the high-speed 


PR 




Job 
tape 


is waiting for input from the 
reader . 


high-speed paper 


RJ 




Job 


is waiting for RJ2780 I/O. 




RN 




Job 


is running or waiting to run. 




RS 




Job 


is waiting for residency. 




SL 




Job 


is sleeping. 




SR 




Job 


is sleeping and is a message 


receiver . 


TT 




Job 


is waiting to perform output 


to a terminal. 



Busy Devices 

The busy device report lists the devices that are assigned or opened 
by a specific user. Items reported are the device specification, the 
job owning that device, and the condition of the device. The disk 
status information reports assigned disk units. The busy device 
report prints on the right-hand side of the screen and looks as 
follows: 

Busy Devices 
Dev Job Why Dev Job Why 
PKO 11 Open Pkl 8 Open 



The DISPLY program reports the same information as SYSTAT reports in 
its busy device report, except that DISPLY prints two side-by-side 
reports to accommodate the limited screen space. Table 14-5 contains 
the abbreviations that can appear in the WHY column of the busy device 
report . 
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Table 14-5: Busy Devices Status Abbreviations: WHY Column 



Abbreviation 


■ + 

1 


Meaning 


AS 


■ + 


Device is explicitly assigned to a job. 


INIT 




Device is open on a channel. 


DOS 




Magnetic tape is assigned with DOS labeling format. 


ANSI 


■ + 


Magnetic tape is assigned with ANSI standard 
labeling format. 



Disks 

The disks report describes each disk in use on the system. The report 
contains the same information that SYSTAT/D displays. The DISPLY 
program prints the following information; however, because of screen 
limitations, it does not print column headings or as much detail as 
SYSTAT does: 

o Disk device specification 

o Number of open files 

o Number of free 512-byte blocks 

o Pack cluster size 

o Disk hardware error count 

o Comments on the status of the disk 

o Pack identification name or system logical names (if any) 
assigned for the devices in use on the system 

The disks report appears on the right-hand side of your terminal and 
looks as follows: 



Disk Structure 



DRO 





17252 


4 





Pri ,DLW 


DR1 


42 


3044 


4 


2 


Pub,DLW 


DR2 





12496 


4 





Pri , R-0 


DR3 


5 


32144 


8 


3 


Pri ,DLW 


DR4 


1 


3272 


4 


1 


Pri ,DLW 


DR5 





532032 


16 


6 


Pri ,R-0 
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To display the pack identification names or system logical names, you 
must use the L command described in Table 14-3. This command displays 
the disk label information in place of the comments that the program 
normally displays. For example: 



Disk Structure 



DRO 





17252 


4 





ROGER 


DR1 


42 


3044 


4 


2 


SYS 


DR2 





12496 


4 





ZEBRA 


DR3 


5 


32144 


8 


3 


ABLE 


DR4 


1 


3272 


4 


1 


MIKE 


DR5 





532032 


16 


6 


YOKE 



If you want to display the comments again, use the -L command. The 
limited size of the screen requires the use of the L and -L commands. 

Table 14-6 lists the abbreviations in the COMMENT column of the disks 
report . 



Table 14-6: Disk Status Abbreviations: COMMENT Column 

+ + + 

| Abbreviation | Meaning | 



Pub 


H 


h 

Cartridge or 


pack is public. 


Pri 




Cartridge or 


pack is private. 


NFS 




Disk is open 


as a non- file - structured device. 


R-0 




Disk unit is 


read-only (write-locked) 


DLW 




Date of last 
last access, 


write (modify), rather than date of 
is stored in file accounting entries. 


Lck 




Disk is in a 


locked state. 


NFF 


H 


New files on this disk are put at the beginning of 
the directory. 

h 
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Message Receivers 

The message receivers report: 

o Provides the job name of the receiving job 

o Provides the job number of the receiving job 

o Includes the number of messages queued for the job 

o Gives the declared maximum number of messages the job can 
queue 

o Tells whether local and network senders are allowed 

o Indicates whether local senders must be privileged 

The message receivers report appears on the right-hand portion of the 
screen and often does not appear until you delete the disk and 
run-time system reports with the -D and - R commands, respectively. A 
sample of the message receivers report is: 



Message receivers 



ERRLOG ( prv ) 


1 





0/40 


OPSER (Loc) 


2 





0/30 


QUEMAN(LOC) 


3 





0/60 


LPOSPL(Prv) 


4 





0/5 


BA0SPL( Prv) 


5 





0/5 


BAlSPL(Prv) 


6 





0/5 


EVTLSN(Prv,Nt) 


7 





0/16 


EVTLOG(Prv) 


7 


1 


0/32 



Due to limited space on the screen, some of the abbreviations are 
shorter than those printed by the /M switch of SYSTAT. The receiver 
report does not include the: 

o Receiver Identification Block (RIB) 

o Object type 

o Number of links used and the maximum links allowed. 

Table 14-7 describes the abbreviations found in the message receiver 
status report. 
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Table 14-7: Message Receivers Abbreviations 



Abbreviation 


■ + 

1 


Meaning 


LOC 


■ + 


Local senders are allowed for this receiver ID. 


Prv 




Local senders must have SEND privilege to send to 
this receiver ID. 


Nt 




Network senders are allowed for this receiver ID. 


IS 




Receiver can handle one and only one link. 


Nl 


■ + 


Both of the above. Network senders are allowed for 
this receiver ID. Receiver can handle one and only 
one link. 



Free Buffers 

The free buffers report provides the following information: 

o Number of general small (16-word) buffers not currently in 
use 

o Number of FIP buffers not currently in use 

o Number of jobs currently running 

o Maximum number of jobs allowed to run 

o Number of hung terminal errors 

o Total number of errors logged on the system 

The report prints the same information the /F switch of the SYSTAT 
program produces. An example of a free buffers report is: 

Gen FIP Jobs TTY Err 
183 1 14/50 9 
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Run-Time Systems 

DISPLY shows the run-time systems report on the right-hand portion of 

the screen. The report includes the same information as SYSTAT/R 

displays, except for: 

o The maximum size in K words that a job running under the 
run-time system can take 

o Some information in the comments column because of limited 
screen space 

The run-time systems report prints: 

o Name of each run-time system 

o Size of the run-time system in K words 

o Number of user jobs currently executing under the control of 
the run-time system 

o Comments regarding the status of the run-time system 

A sample run-time systems report is: 



Run - time 


systems : 










Name 


Ext 


Dev 


Size 


Users 


Comments 




. . .RSX 


Tsk 




0( 32)K 


22 


Monitor 




RSX 


Tsk 


DR1 


1(28)K 





Primary, Perm, 


Addr: 71, KBM 


DCL 


Com 


DR1 


27(4)K 


7 


Temp, Addr : 385 , 


DF KBM 


TECO 


Tec 


DR1 


: 10(20)K 





Temp, Addr: 298, 


KBM 


RT11 


Sav 


DR1 • 


4(28)K 





Temp, Addr:104, 


KBM, CSZ, EMT:255 


BAS4AL 


Bac 


DR1 


17(12)K 





Temp, Addr: 416, 


KBM, CSZ 


BAS4F 


Bac 


DR1: 


15(16)K 





Temp, Addr:114, 


KBM, CSZ 


BASIC 


Bac 


DR1 , 


. 13(16)K 





Temp, Addr:200, 


KBM, CSZ 


FORTH 


4th 


DR1 


: 6(24)K 





Temp, Addr:108, 


KBM, NER, CSZ 



Table 14-8 contains a list and description of each abbreviation that 
DISPLY prints in the COMMENTS column. 
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Table 14-8: Run-Time Systems and Resident Libraries Report 
Abbreviations 

+ + + 

| Abbreviation | Meaning | 



Non- res 


| Run-time system or library is nonresident. 


Loading 


| Run-time system or library is being loaded into 
| memory. 


Temp 


| Run-time system or library is removed from memory 
j when not being used. 


Perm 


| Run-time system or library stays in memory when not 
| being used. 


Addr : xxx 


| The value of xxx denotes the starting address of 
| the run-time system or library. 


[DF] KBM 


| Run-time system or library can serve as a keyboard 
| monitor. The optional prefix DF indicates default 
| keyboard monitor. 


1US 


| Run- time system or library can serve only one user. 


R/W 


| Run-time system or library allows read/write 
| access. 


M TT* 

NER 


| Errors occurring within the run-time system or 
| library are not sent to the system error log. 


Rem 


| Run-time system or library is removed from memory 
| as soon as all of its jobs switch to another 
| run-time system or library. 


CSZ 


| Proper job image size (in K words) to run a program 
| can be computed as K-size=(file size+3)/4. 


EMT:yyy 


| Denotes the EMT code for special EMT prefix. 



Resident Libraries 

The resident libraries report includes: 
o Name of the resident library 
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o Protection code of the resident library 

o Size of the resident library 

o Number of user jobs currently executing under its control 

o Comments regarding the status of the resident library 

DISPLY shows the resident libraries report on the right-hand portion 
of the screen. The report shows the same information as SYSTAT/L 
displays. Some information in the COMMENTS column may be omitted due 
to limited space on the screen. See Table 14-8 for a description of 
the abbreviations used in the COMMENTS column. 



Memory Status 

The S command causes the program to print a table that shows the use 
of each lK-word portion of memory. The memory status report replaces 
the job status report on the lefthand half of the screen. Use the J 
command to display the job information again. 

Type the S command to have DISPLY print the memory status report as in 
this example: 



Memory usage (Starting at OK) 






MON 


MON 


MON 


MON 


MON 


MON 


MON 


8 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


16 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


24 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


32 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


40 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


48 


MON 


MON 


MON 


MON 


MON 


MON 


MON 


56 


*1 * 


*1* 


*1 * 


*1 * 


*1* 


*1* 


*1* 


64 


*1 * 


*]_* 


*1 * 


*1 * 


*]_* 


*1* 


*1* 


72 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


80 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


88 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


96 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


104 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


112 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


120 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


128 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


136 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


144 


XBF 


XBF 


XBF 


XBF 


XBF 


XBF 


7 


152 


7 


7 


7 


7 


7 


7 


7 


160 


7 


7 


7 


7 


7 


7 


7 



Due to limited screen space, the program may not be able to display 
all memory status information simultaneously. The Sn command lets the 
user determine the starting 8K section. The display program prints 
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the starting section number for the row and eight abbreviations per 
row. Each of the abbreviations relates to the status of a IK section 
of memory. The number of rows the program prints and the extent of 
memory covered is limited by the terminal. The program indicates the 
starting IK section by printing a header line in the following format: 

MEMORY USAGE (STARTING AT nK ) 

Table 14-9 contains a description of the abbreviations the memory 
status report uses. 



Table 14-9: Memory Status Report Abbreviations 



Abbreviation 


1 


Meaning 


MON 




Occupied by the RSTS/E monitor. 






Occupied by run-time system n, where n is the 
position in the run-time system list. (A question 
mark is printed if the run-time system name cannot 
be determined . ) 


-n - 




Occupied by resident library n, where n is the 
position in the resident library list. 


n 




Occupied by job number n. 


nLK 




Job number is locked in this IK portion. 


nS 




Job number n is being swapped out of memory. 


nSI 




Job number n is being swapped into memory. 


NXM 




Memory space is nonexistent. 


END 




End of physical memory for user jobs. 


LCK 




Memory is locked. 


XBF 




Memory is reserved for the extended buffer pool 
(XBUF) . 



DCL Command Descriptions 

The following sections describe the DCL commands for the miscellaneous 
system functions. 
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LOAD/OVERLAY Command 

The LOAD/OVERLAY command lets you load monitor overlays in memory 
during timesharing. By making certain monitor functions resident in 
memory, you can improve the system's performance at the cost of 
increased memory (XBUF) usage. LOAD/OVERLAY requires SWCFG privilege 



Format 

LOAD/OVERLAY ove r lay - name [ , 

Command Qualifiers 

/ALL 

Prompts 

Overlay: overlay-name [,... ] 



Defaults 



Command Parameters 
overlay-name 

Specifies the monitor overlay that you want to load into memory. 
The allowable values are: 

o ATTRIBUTE -- Indicates the monitor overlay that performs file 
and account attribute read/write operations. 

o DCL -- Indicates the monitor overlay that performs 
file-related operations for DCL. 

o DELETE_RENAME -- Indicates the monitor overlay that performs 
file deletion and renaming. 

o DIRECTORY -- Indicates the monitor overlay that performs disk 
file lookup operations. 
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o SYSTEM__CALLS -- Indicates the monitor overlay that performs 
all of the following monitor directives: 

- Get monitor tables (parts 1 , 2 , and 3 ) 

Return open file information 

Date and time conversion 

Return job status 

o TERMINAL Indicates the monitor overlay code that performs 
terminal attribute read/write operations. 

Command Qualifiers 

/ALL 

Indicates that all possible overlays should be loaded into 
memory. If you specify this qualifier, RSTS/E does not allow any 
overlay names. 
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SET DATE Command 

The SET DATE command sets the RSTS/E system date to the value you 
specify. Optionally, you can specify a new value for the system time. 
You can specify relative values for the date or time. SET DATE 
requires the DATES privilege. 

+ + 

I Format j 

j SET DATE date [: time] j 

| Prompts j 

j None | 
+ + 

Command Paramters 

date 

Specifies the system date. Insert a space between the date field 
and the DCL command. You can specify a relative date with the 
keyword DAYS. 

[ : time ] 

Specifies the system time. You can specify a relative time with 
the keywords; HOURS and MINUTES. Insert a colon (:) between the 
date and time fields. 

Note 

When you specify the AM/PM suffix, there is no 
space between the minutes and the suffix. For 
example: 

SET TIME 1:30PM 
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SET SYSTEM Command 

The SET SYSTEM command sets the default system characteristics. You 
need one or more privileges to use this command (see the discussion 
for each command qualifier). 



Format 

SET SYSTEM 

Command Qualifiers 

/DATE_FORMAT= format 

/DENSITY=default 

/HANGUP= { DELAYED | IMMEDIATE } 

/HOLD 

/LABEL=def ault 

/NAME=" installation name" 

/ [ NO ] PAS SWORD_PROMPT [ = ( type [ , 

/POWERFAI L_DELAY=n 

/RELEASE 

/TIME_FORMAT= format 

Prompts 

None 



] ) ] 



Defaults 

See Discussion 
See Discussion 
/HANGUP=DELAYED 

See Discussion 

See Discussion 

See Discussion 



Command Qualifiers 
/DATE_FORMAT= f o r ma t 

Sets the default date format: 



O ALPHABETIC 
(DD-MMM- YY) 



Sets the default date format to alphabetic 



o NUMERIC -- Sets the default date format to numeric (YY.MM.DD) 
You need SWCFG privilege to specify this qualifier. 
/DENSITY=default 

Sets the default magnetic tape density: 
o 800 -- Sets the default magnetic tape density to 800 bpi 
o 1600 -- Sets the default magnetic tape density to 1600 bpi 
You need HWCFG privilege to specify this qualifier. 
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/HANGUP = { DELAYED | IMMEDIATE } 

Sets whether or not the system delays hanging up dial-up lines 
when carrier is dropped. The default is DELAYED, which means the 
system waits approximately five seconds before hanging up a 
dial-up line. 

Setting IMMEDIATE means the system hangs up a dial-up line as 
soon as the carrier is dropped. IMMEDIATE is mainly used for 
European dial-up lines. You need SWCFG privilege to use this 
qualifier . 

/HOLD 

Stops execution of all jobs except the one issuing the command. 
You need HWCTL privilege to use this qualifier. 

/LABEL=default 

Sets the default magnetic tape label: 

o ANSI -- Sets the default magnetic tape label to ANSI 

o DOS -- Sets the default magnetic tape label to DOS 

You need SWCFG privilege to use this qualifier. 

/NAME="installation name" 

Sets the system name to the name you specify. You can specify up 
to 15 characters in the name. You need SWCFG privilege to use 
this qualifier. 

/ [ NO ] PAS SWORD_PROMPT [ = ( type [,...])] 

Specifies the types of users that must enter the system password. 
If you do not specify any types, all users must enter the 
password. If you want to limit prompting to remote users, use 
the types NETWORK and DIALUP. You need WACNT privilege to use 
this qualifier. 

/POWERFAI L__DELAY=n 

Sets the power fail delay to n. When a power failure occurs, the 
system waits n seconds before rebooting the system. The value of 
n can range from 1 to 300. You need SWCFG privilege to use this 
qualifier . 

/RELEASE 

Resumes execution of all jobs on the system. You need HWCTL 
privilege to use this qualifier. 
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/TIME_FORMAT= format 

Sets the default time format: 

o AM_PM -- Sets the default time format to AM/PM time (01:30PM) 

o 24_HOUR -- Sets the default time format to 24 -hour time 
(13:30) 

You need SWCFG privilege to use this qualifier. 
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SET TIME Command 

The SET TIME command sets the RSTS/E 24 -hour clock to the value you 
specify. Optionally, you can set the system date to the value you 
specify. You can specify relative values for the date or time. SET 
TIME requires the DATES privilege. 

+ + 

| Format | 

| SET TIME [date:]time | 

| Prompts | 

j None | 
+ + 

Command Parameters 

[ date : ] 

Specifies the system date. If you specify this optional field, 
insert a space between the DCL command and the date field and 
insert a colon between the date and time fields. You can specify 
a relative date with the keyword DAYS. 

time 

Specifies the system time. You can specify a relative time with 
the keywords; HOURS and MINUTES. 

Note 

When you specify the AM/PM suffix, there is no 
space between the minutes and the suffix. For 
example : 

SET TIME 1:30PM 
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SHOW SYSTEM Command 



The SHOW SYSTEM command displays the system default characteristics as 
follows : 



System name: 

Date format: 

Time format: 

Magtape label default: 

Magtape density default: 

Power fail restart delay: 

Hangup : 

Job limit: 
Current jobs: 

Password Prompting: 



RSTS V9.0 EDERE 

Alphabetic 

AM_PM 

ANSI 

1600 BPI 

300 seconds 

Delayed 

44 
26 

Network and Dialup users 



The SHOW SYSTEM command does not require any privileges. 

+ - - + 

Format 
SHOW SYSTEM 

Command Qualifiers Defaults 
None 
Prompts 
None 



+ 



- + 



The SHOW SYSTEM command has no qualifiers or prompts. 
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UNLOAD/OVERLAY Command 

The UNLOAD/OVERLAY command lets you unload monitor overlays that were 
loaded into memory with the LOAD/OVERLAY command. UNLOAD/OVERLAY 
requires SWCFG privilege. 



Format 

UNLOAD/OVERLAY ove r lay - name [ , . . . ] 

Command Qualifiers 

/ALL 

Prompts 

Overlay: overlay-name [,... ] 



Defaults 



Command Parameters 
overlay-name 

Specifies the monitor overlay that you want to unload from 
memory. The allowable values are: 

o ATTRIBUTE -- Indicates the monitor overlay that performs file 
and account attribute read/write operations. 

o DCL -- Indicates the monitor overlay that performs 
file-related operations for DCL. 

o DELETE_RENAME Indicates the monitor overlay that performs 
file deletion and renaming. 

o DIRECTORY -- Indicates the monitor overlay that performs disk 
file lookup operations. 
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o SYSTEM__CALLS Indicates the monitor overlay that performs 
all of the following monitor directives: 

Get monitor tables (parts 1, 2, and 3) 

Return open file information 

Date and time conversion 

Return job status 

o TERMINAL Indicates the monitor overlay code that performs 
terminal attribute read/write operations. 

Command Qualifiers 

/ALL 

Indicates that all possible overlays should be unloaded from 
memory. If you specify this qualifier, RSTS/E does not allow any 
overlay names. 
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Chapter 
Managing Disks 



15 



and Tapes 



This chapter describes the DCL commands that you use to manage RSTS/E 
disks and tapes. First, Table 15-1 lists and briefly describes the 
DCL commands available to you. Then, the chapter provides background 
information about disk and tape handling on RSTS/E. Finally, the 
chapter lists each command alphabetically and explains it in more 
detail. 



Some functions of INITIALIZE, MOUNT, and DISMOUNT require privilege. 
This manual describes all the functions. The RSTS/E System User's 
Guide also describes those functions that do not require any 
privileges . 



Table 15-1: DCL Commands for Disk and Tape Handling 



+ + 

| Command | 
+ + 

INITIALIZE 



MOUNT 



DISMOUNT 



+ 



Meaning 



Initializes a disk or magnetic tape. Use this command 
to prepare the medium for writing new files. 

Logically mounts a disk or magnetic tape. Use this 
command after you physically mount the disk or tape 
on the device. 

Logically dismounts a disk or magnetic tape. Use this 
command before you physically dismount the disk or 
tape from the device. 



- - + 



- + 



Working with Disks and Tapes 

The system manager or operator is often responsible for mounting and 
dismounting disk packs and magnetic tapes. Indeed only a user with 
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MOUNT privilege can load disks on the public structure. Thus, you 
need to be familiar with commands that prepare tapes and disks for 
use: INITIALIZE, MOUNT, and DISMOUNT. 



Initializing Disks and Tapes 

Initializing a disk or tape makes it "like new." You should consider 
initializing if you have : 

o An old disk or tape to recycle; you initialize it to 
eliminate any existing files that it contains. 

o A new disk or tape; you initialize it to perform all the 
necessary actions that make it usable on your system. (The 
INITIALIZE command descriptions explain these necessary 
actions . ) 

Certain disks require formatting before they are initialized. 
Formatting writes timing and sense marks onto the disk and destroys 
any information that the disk contains. You format disks using the 
DSKINT option of INIT.SYS; for a description see the RSTS/E 
Installation and Update Guide. 

You must shut the system down to format the following disks before 
using them on a RSTS/E system: RK05, RK05F , RP02, and RP03. 

Note 

These disks need to be formatted only once. All 
other disks have been formatted at the factory and 
need not be formatted again. 

The DSKINT option also creates a RSTS/E file structure on the disk. 
You can later use the DCL INITIALIZE command to clear the disk of 
files and recreate the RSTS/E file structure. 

The INITIALIZE command: 

o Has different qualifiers for disk initialization from those 
for tape initialization. 

o Requires WRTNFS privilege when used for disks. 

The section "INITIALIZE Command for Tapes" describes tape 
initialization. See the RSTS/E System User's Guide for nonprivileged 
uses of the INITIALIZE command. 
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Mounting and Dismounting Tapes and Disks 

Whenever you want to use. a different tape or disk from that which is 
mounted, you must logically dismount the current disk or tape (using 
the DISMOUNT command), and physically remove the disk or tape from the 
drive. Then you physically mount the new disk or tape on the drive 
and place the drive on line. 

After physically mounting and activating the medium, you must 
logically mount the new disk or tape (using the MOUNT command). This 
allocates the drive for appropriate use. For example, a tape drive is 
allocated for use only through your account. A disk drive with a pack 
initialized and mounted as public becomes part of the public 
structure. It can be used by anybody on the system. 

The MOUNT command prepares an initialized disk or tape for processing 
by system commands or user programs. The DISMOUNT command releases a 
disk or tape that was previously accessed with a MOUNT command. Both 
MOUNT and DISMOUNT have different qualifiers when used with disks or 
tapes . 



DCL Command Descriptions 

The following sections describe the DCL commands for managing RSTS/E 
disks and tapes. 
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DISMOUNT Command for Disks 

The DISMOUNT command for disks releases a disk previously accessed 
with a MOUNT command. You issue this command before you take the 
drive off line or before you physically dismount the disk. You can 
dismount any disk with MOUNT privilege. Without MOUNT privilege, you 
can only dismount a disk mounted /NOSHARE for your job. 

The DISMOUNT command deallocates the disk if it was allocated to you. 
You cannot DISMOUNT a device if there are open files on it. If you 
try, the system displays the error message: 

?Account or device in use 

+ + 

| Format | 

I DISMOUNT disk -device -name [: ] [pack-id] j 

| Command Qualifiers Defaults | 

I /PUBLIC None | 

| Prompts | 

| Device: device -name [: ] | 
+ + 

Command Parameters 

disk -device -name [ : ] 

The physical or logical name of the disk unit containing the pack 
to be dismounted. If you do not specify a unit number, the 
following error message appears: 

?Unit number needed 

pack - id 

The pack-id specified when the disk was initialized and mounted. 
The pack-id is deassigned as a system-wide logical. The pack-id 
is optional. 
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Command Qualifiers 
/PUBLIC 

You need MOUNT privilege to dismount a public disk. (The disk 
must have been mounted and initialized as public.) 

If you do not specify /PUBLIC, the system assumes that the disk 
was mounted as private. If you try to dismount a public disk 
without the /PUBLIC qualifier, you get the error message: 

?Disk is mounted public 

If you try to dismount a disk by using the /PUBLIC qualifier and 
the disk was mounted as private, you get the error message: 

?Disk is mounted private 

If you do not have MOUNT privilege you can only dismount private 
disks if they were mounted /NOSHARE. If you try to dismount a 
public disk, you get the error message: 

?You have MOUNT privilege to dismount a public disk 

If the disk was mounted with the /NOSHARE qualifier, and any 
unprivileged job except the one to which the disk is assigned 
attempts to dismount it, the following error message appears: 

?Account or device in use 
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DISMOUNT Command for Tapes 

The DISMOUNT command for tapes releases a tape previously accessed 
with a MOUNT command. You issue this command before you take the 
drive off line or before you physically dismount the tape. The 
DISMOUNT command deallocates the tape drive if it was allocated to 
you. You cannot DISMOUNT a tape if there are open files on it. Any 
attempt to do so returns the error message: 

?Account or device in use 

When used for tapes, the DISMOUNT command does not require any 
privileges . 

+ + 

| Format | 

I DISMOUNT tape -device -name [: ] [label] | 

I Command Qualifiers Defaults | 

| /[NO] UNLOAD /UNLOAD | 

| Prompts | 

| Device: device -name [: ] | 
+ + 

Command Parameters 

tape -device -name [ : ] 

Specifies the physical or logical name of the drive on which the 
tape is to be dismounted. If you do not specify a unit number 
with a physical device name, the default is unit 0. 

label 

Specifies the label on an ANSI tape. Note that it is not 
necessary to specify a label with the DISMOUNT command. However, 
if you are using a hard-copy terminal, you can specify a label to 
keep a log of the tape being dismounted. The label you specify 
is ignored; it is not checked against the label on the tape. 

Command Qualifiers 

/[NO] UNLOAD 

Specifies whether to unload the tape from the drive. Once a tape 
is unloaded, it must be manually loaded before it can be mounted 
again. The default is /UNLOAD. 
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INITIALIZE Command for Disks 

The INITIALIZE command creates a RSTS/E file structure on a disk; that 
is, it prepares a disk so files can be written to it and read from it. 
(Be aware that INITIALIZE overwrites any data previously written to 
the disk unless you specify the /NOEXERCISE/NOERASE qualifier.) 

In creating a RSTS/E file structure for the disk, INITIALIZE writes 
several structures to the disk. For example, INITIALIZE creates a 
User File Directory (UFD) for account [0,1] that contains entries for 
the files SATT.SYS (the storage allocation table) and BADB.SYS (the 
bad block f ile ) . 



When used for disks, the INITIALIZE command requires WRTNFS, RDNFS, 
and WREAD privileges. 



Note 



When you issue the INITIALIZE command, the disk 
should only be physically mounted in the drive; it 
should not be logically mounted. 



+ 



+ 



Format 



INITIALIZE disk -device -name [: ] pack-id 



Command Qualifiers 



Defaults 



/CLUSTER_SIZE=n 

/DATE=ACCESSED 

/DATE=MODIFIED 

/[NO ] ERASE 

/[NO]EXERCISE=n 

/INDEX=position 

/MFD__CLUSTER_SIZE=n 

/PRIVATE 

/PUBLIC 

/[NO] QUERY 

/[NO] RETAIN 

/[NO]WRITE 



n=device cluster size 
/DATE=MOD I F I ED 
/DATE=MODIFIED 
/ERASE 

/EXERCISE=FULL 

/INDEX=MIDDLE 

n=16 

/PRIVATE 

/PRIVATE 

/QUERY 

/RETAIN 

/WRITE 



Prompts 



None 



+ 



+ 
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Command Parameters 

di sk -device -name [ : ] 

Specifies the name of the drive on which the disk is physically 
mounted. 

pack-id 

One- to six - alphanumeric characters to be used when logically 
mounting the disk. By default, RSTS/E uses this pack-id as a 
system-wide logical name for the mounted disk. 

Command Qualifiers 

/CLUSTER_SIZE=n 

Declares the pack cluster size, which is the minimum allocation 
unit, in 512-byte blocks, for the disk. All files written to 
this disk use multiples of n blocks, where n is the pack cluster 
size. 

In general, the cluster size specified (n) must be a power of 2 
(1, 2, 4, 8, 16), equal to or greater than the device cluster 
size, but not greater than 16. If you do not specify a cluster 
size, RSTS/E assumes the device cluster size. 

The /CLUSTER__SIZE=n option affects performance. In general, a 
large pack cluster size speeds disk I/O operations, but wastes 
disk space. For example, if you declare /CLUSTER_SIZE=16 for a 
disk, a file consisting of 8193 bytes (16 512-byte blocks plus 
one byte) requires 2 pack clusters, or 32 blocks. A 
/CLUSTER_SIZE=8 for the same file would require three clusters, 
or 24 blocks, of disk storage. 

Table 15-2 lists the device cluster sizes for the disks that 
RSTS/E supports. 



Table 15-2: Disk Size and Cluster Size 

+ + + - + + 

| | Device | Acceptable Pack | Total | 
j Disk | Cluster | Cluster Size | Device Size | 
| Type j Size j (/CLUSTER^SIZE ) | (Blocks) j 
+ + + -- + + 



RX50 | 


1 


1 1, 


2, 


4, 


8, 


16 


| 800 


RK05 j 


1 


1 1/ 


2, 


4, 


8, 


16 


| 4800 


RK05F 

1 


1 


1 1, 

1 


2, 


4, 


8, 


16 


| 4800 for each unit; 
j 2 units per drive 


RL01 | 


1 


1 1/ 


2, 


4, 


8, 


16 


| 10220 
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Table 15-2: Disk Size and Cluster Size (Cont.) 



Device 



Acceptable Pack 



Disk 
Type 


| Cluster 
| Size 


| Cluster Size 

j (/CLUSTER, SIZE) 


| Device Size 
| (Blocks) 




- + 








- + 


RL02 


| 1 


1 1 / 


2 , 


4 , 8 , 16 


| 20460 


RD51 


| 1 


1 1 / 


2 , 


4, 8, 16 


21600 


RD52 


I 1 


1 1 / 


2 / 


4 , 8 , 16 


| 60479 


RC25 


| 1 


1 1 / 


2 , 


4 , 8 , 16 


j 50902 for each unit; 




1 








| 2 units per drive 


RK06 


| 1 


1 1 / 


2 , 


4 , 8 , 16 


27104 


RK07 


| 1 


1 1 / 


2 / 


4 8 16 


| 53768 


RP02 


1 2 


1' 2 f 


4, 


8, 16 


| 40000 


RP03 


1 2 


1 2, 


4, 


8, 16 


| 80000 


RM02 


1 4 


1 4, 


8, 


16 


| 131648 


RM03 


1 4 


1 4, 


8, 


16 


| 131648 


RP04 


1 4 


1 4, 


8, 


16 


| 171796 


RP05 


1 4 


1 4, 


8, 


16 


| 171796 


RA80 


4 


1 4, 


8, 


16 


| 237208 


RM80 


1 4 


1 4, 


8, 


16 


| 242575 


RP06 


1 8 


1 8, 


16 




| 340664 


RA60 


1 8 


1 8, 


16 




| 400175 


RM05 


1 8 


1 8, 


16 




| 500352 


RA81 


1 16 


I 16 






1 888012 



Total 



/DATE=ACCESSED 
/DATE=MODIFIED 



Lets you specify whether to record a file's date of last access 
(=ACCESSED) or of last modification (=MODIFIED). The default is 
/DATE=MODIFIED. 



/[NO] ERASE 



Indicates whether the data on the specified disk is erased. The 
/NOERASE qualifier applies only if you specify /NOEXERCISE. The 
default is /ERASE. 



Note 



Using /NOERASE may cause sensitive data to remain 
on the disk. If the disk contained files marked 
as 'erase on delete' (protection code of 128 or 
higher), you should not use /NOERASE unless you 
are sure that no security problems will result. 
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/EXERCISE=n 
/NOEXERCISE 

Controls whether to check for bad blocks by "exercising" the 
disk. This means that the number of patterns you select (n) are 
written to the disk, and then each block is read to make sure 
that the patterns were written correctly. If the patterns read 
do not match the patterns written, RSTS/E assumes the block is 
bad. RSTS/E adds any bad blocks found to the "bad block" file 
(BADB.SYS in account [0,1] on the disk). RSTS/E does not store 
data in any blocks allocated to the BADB.SYS file. 

You can have the INITIALIZE command run from zero to three 

patterns by specifying 0, 1, 2, or 3 for n. Each pattern 

consists of three octal words; the pattern used for each of these 
numbers is: 

Pattern Three Octal Words 

1 155555 133333 066666 

2 133333 066666 155555 

3 066666 155555 133333 

For example, /EXERCISE=2 causes pattern 1 to be written to and 
read from the disk, followed by pattern 2 being written to and 
read from the disk. 

You can also select the default, /EXERCI SE=FULL , which uses all 
three patterns, one at a time. That is, each block is written to 
and read from the disk three times, each time with a different 
pattern. Using the FULL argument increases the probability that 
all bad blocks are found, and decreases the probability that you 
will lose information later by writing into a bad block. (Note 
that /EXERCI SE=FULL is equivalent to /EXERCISE=3 . ) 

The /NOEXERCISE qualifier indicates that you do not want to check 
for bad blocks. For example, if you previously initialized the 
disk and feel that the current bad block file is accurate, you 
can save time by specifying the /NOEXERCISE qualifier. This 
still writes one pattern all over the disk unless you specify 
/NOERASE, but it does not read it back in. (Note that 
/NOEXERCISE is equivalent to /EXERCISE=0 . ) 

/INDEX=position 

Positions the SATT.SYS file on the disk. SATT.SYS is the storage 
allocation table created in account [0,1] during initialization. 
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The position argument can be: 

BEGINNING Puts SATT.SYS at the beginning of the disk, which 

avoids fragmenting the disk. That way, more 
contiguous space is available to store other files 
on the disk. 

MIDDLE Puts SATT.SYS in the middle of the disk. For 

moving-head disks, it helps to locate SATT.SYS 
near the middle of the disk, which reduces average 
seek times for the disk heads. MIDDLE is the 
default if you do not specify the /INDEX option. 

n Puts SATT.SYS at device cluster number n, where n 

can range from 1 to the total device size divided 
by the device cluster size. See Table 15-2 for 
these values. 

/MFD__CLUSTER_SIZE=n 

Declares the minimum allocation unit, in 512-byte blocks, for the 
Master File Directory (MFD). The MFD is a special "catalog" 
structure that RSTS/E creates during disk initialization. Along 
with other key structures, RSTS/E update the MFD each time users 
add or delete accounts and files on the disk. Because RSTS/E 
must access the MFD frequently, you increase performance when the 
MFD cluster size is large. On the other hand, a small MFD 
cluster size can save some disk space. 

The MFD cluster size (n) can be 4, 8, or 16; it must be greater 
than or equal to the value entered for the CLUSTER_SIZE 
qualifier. The default is /MFD_CLUSTER_SIZE=16 . 

/PRIVATE 

Allows only users who have accounts on a disk to access it. If 
you do not specify /PUBLIC or /PRIVATE, then RSTS/E assumes 
/PRIVATE . 

You can create a system disk by initializing the disk as /PRIVATE 
and then using the CREATE/ACCOUNT command to create and position 
accounts [1,1] and [1,2]. In this case, note that you must 
transfer files to the disk and use the HOOK utility to make it a 
RSTS/E system disk. 

/PUBLIC 

Allows anyone with an account on the system to access the disk. 

You can use /PUBLIC to identify any disk on the system as public, 
except the system disk. When the disk is mounted, it is 
considered part of the public structure. You need MOUNT 
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privilege to mount a public disk. After you mount it, the disk 
is a logical extension of the system disk; thus, any user can 
create files on it. 

In general, DIGITAL recommends against using /PUBLIC, because it 
can degrade performance over time. Consider the following points 
if you decide to select /PUBLIC for disks on your system: 

o If your system disk is nearly full, and you want to dedicate 
one or more additional disks to general file storage, you 
might add public disks to your system. Users are not 
generally aware of whether their files are on the system disk 
or a public disk. 

o A public disk is an extension of the system disk; therefore, 
it should always remain mounted during timesharing. In 
addition, you must remount it every time you restart the 
system. If you dismount the disk during timesharing, some 
users' files will mysteriously (to them) disappear. 
Dismounting a public disk causes disruption unless you 
transfer all of the files on the disk to the system disk or 
to some other public disk. 

o Before adding a public disk to your system, consider the 
alternative of adding a private disk for use by specific 
users. DIGITAL recommends this alternative because it yields 
significantly better system performance. However, this means 
that you must create accounts explicitly on the private disk. 
In addition, users who have accounts on the disk must refer 
explicitly to that disk in file specifications. 

Because of these considerations, the system provides several 
safety checks on initializing and mounting a public disk. First, 
you must have MOUNT privilege to do so. Second, you must specify 
/PUBLIC two times: when you initialize the disk, and when you 
mount the disk. 

/QUERY 
/NOQUERY 

When you use the /QUERY qualifier, INITIALIZE displays the 
characteristics of a disk you have selected that already has a 
RSTS/E file structure, and asks if you still want to initialize 
the disk. 

Thus, /QUERY lets you verify that you are initializing the disk 
you intended, thereby keeping you from accidentally wiping out 
the wrong disk. If you specify /NOQUERY, INITIALIZE simply 
displays the characteristics of the disk before overwriting its 
contents. The default is /QUERY. 
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The display of disk characteristics is similar to: 

This disk pack appears to be a RSTS/E formatted 
disk with the following characteristics: 

Pack ID : THELMA 
Pack Cluster Size : 4 
Pack is currently : Private, 

Level 1.2 

Proceed (Y or N ) ? 

You must respond to the prompt with YES or NO, or some 
abbreviation of these. NO cancels the initialization; YES 
requests that it proceeds. There is no default response to the 
prompt . 

/RETAIN 
/NORETAIN 

Controls whether to use a previously initialized disk's bad block 
file. A disk that has not been previously initialized has no bad 
block file. In this case, /RETAIN and /NORETAIN are meaningless, 
and are ignored if specified. /RETAIN is the default on a 
previously initialized disk. 

If you use both the /RETAIN and /EXERCISE qualifiers, the 
INITIALIZE command keeps the old bad block file and adds any 
additional bad blocks it finds while it is checking the disk for 
bad blocks. 

If you specify /NOEXERCISE, then you should use /RETAIN. Because 
/NOEXERCISE does not exercise the disk for bad blocks, you should 
use /RETAIN to keep the existing bad block information. 

The /NORETAIN qualifier is useful if problems with a disk drive 
have been causing apparent bad blocks on a disk. After you learn 
that the problem is with the drive, you can recover space on the 
disk by using /NORETAIN. 

/WRITE 
/NOWRITE 

Determines whether the disk should default to read-only 
(/NOWRITE) or read/write (/WRITE) access when it is mounted. 
This is useful when you initialize a disk that is usually mounted 
read-only. The default is /WRITE. 

When mounting a disk, you can override the read-only access by 
specifying the /WRITE qualifier with the MOUNT command. 
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INITIALIZE Command for Tapes 

The INITIALIZE command for tapes prepares a new tape or recycles a 
used tape that contains no useful files. The INITIALIZE command for 
tapes makes any existing data on the tape unavailable to 
file - structured access. For ANSI tapes, it also writes a label that 
RSTS/E uses to identify the tape in a MOUNT command (ANSI tapes 
require a label). INITIALIZE allocates the tape drive if it is not 
already allocated. 

When used for tapes, the INITIALIZE command does not require any 
special privilege unless the device is restricted. If so, DEVICE 
privilege is required. 

+ + 



Format 

INITIALIZE tape -device -name [: ] [label] 



Command Qualifiers 



Defaults 



/DENSITY=nnn 
/FORMAT=ANS I 
/FORMAT=DOS 



See Discussion 
See Discussion 
See Discussion 



Prompts 

Device: magtape[:] 
Label: label (if ANSI) 
Proceed (Y or N) ? 
+ 



+ 



Command Parameters 

tape-device-name[ : ] 

Specifies the name of the drive on which the tape is physically 
mounted. 



[label] 



Specifies the identification label to be encoded on the tape. 
The label can consist of a maximum of six alphanumeric 
characters . 



An ANSI -format tape requires a label; RSTS/E prompts you for a 
label if you do not specify one. RSTS/E checks this label 
against the label you specify when you later use the MOUNT 
command (see the section "MOUNT Command for Tapes"). 
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DOS tapes do not allow labels: RSTS/E ignores any label you 
specify for them and displays a warning message. 

Command Qualifiers 

/DENS I TY=nnn 

Specifies the density in bits per inch (bpi) at which the tape is 
to be written. You can specify a density of either 800 or 1600 
bpi if the tape drive supports it. 

The default density is the value specified using the DCL command, 
SET SYSTEM/DENS I TY= (see Chapter 14), unless the controller does 
not support that density. 

/FORMAT=ANS I 
/FORMAT=DOS 

Specifies the tape format. If you do not specify a format, the 
system uses the current system default (SHOW SYSTEM command 
displays the current system defaults). You can change the 
default format using the DCL command, SET SYSTEM/LABEL= (see 
Chapter 14). As mentioned earlier, ANSI format requires a label; 
DOS format ignores any label specified. 
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MOUNT Command for Disks 

The MOUNT command prepares an initialized disk for processing under 
timesharing. To mount a disk, you must: 

1. Physically mount the disk on a device drive 

2. Put the drive on line 

3. Use the MOUNT command to logically mount the disk 

You need the MOUNT privilege to mount a disk that has been initialized 
as public. For users with MOUNT privilege, the MOUNT command rebuilds 
a "dirty" disk one that has been physically dismounted (removed 
from the drive) or taken off line without being logically dismounted 
first with the DISMOUNT command. This is the only time that a disk's 
"dirty" bit is set, although you may choose to rebuild the disk at 
other times to maintain integrity of its structure. 

If MOUNT discovers the disk needs rebuilding, it displays the message: 

Disk is being rebuilt - wait... 

The rebuild operation proceeds and the disk is logically mounted when 
the dollar prompt ($) for the next DCL command appears. However, if 
the rebuild operation discovers blocks that have been allocated to 
more than one file (doubly allocated blocks), MOUNT displays a message 
asking which file to allocate each doubly allocated block to. You can 
choose a file at that point or stop and mount the disk without 
rebuilding, which lets you examine the situation further. 

+ + 



Format 



MOUNT disk -device -name [: ] pack-id [ logical -name[ :] ] 



Command Qualifiers 



Defaults 



/PRIVATE 
/PUBLIC 
/[NO] QUOTA 
/[NO ] REBUILD 
/[NO ] RESTRICT 
/[ NO ] SHARE [=n] 
/[NO]WRITE 



/PRIVATE 
/PRIVATE 



See Discussion 
See Discussion 
/NORESTRICT 



See Discussion 
See Discussion 



Prompts 



Device: device -name [: ] 
Pack-id: pack-id 



+ 



+ 
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Command Parameters 

disk -device -name [ : ] 

Specifies the physical or logical name of the drive containing 
the disk you want to logically mount. 

pack - id 

Specifies the one to six character alphanumeric pack 
identification label written to the disk during initialization. 
(See the INITIALIZE command description in the section 
"INITIALIZE Command for Disks.") MOUNT then verifies that the 
pack-id written on the disk is the same as the label you 
specified in the MOUNT. This process helps make certain that you 
physically mounted the right disk. 

You must include a pack-id to mount a disk. If you omit the 
pack-id, the system prompts you for it. 

[ logical -name [ : ] ] 

Lets a user with INSTAL privilege assign a system-wide logical 
name to the disk drive specified by a device name. If you do not 
specify a logical name and you have INSTAL privilege, the system 
uses the pack-id label as a system-wide logical name for the 
drive. You may want to use this logical name to keep the pack-id 
from unauthorized users. Unauthorized users can see logical 
names assigned to devices in SYSTAT. RSTS/E ignores the 
specification of a logical name by an unauthorized user (without 
INSTAL privilege), but the mount succeeds. 

Command Qualifiers 

/PRIVATE 
/PUBLIC 

Declares that the disk you are mounting is accessible to all 
users on the system (a public disk), or only accessible to users 
who have accounts on the disk (a private disk). The default is 
/PRIVATE. 

The action taken for /PRIVATE and /PUBLIC depends on two things: 

o Whether you have MOUNT privilege when issuing the MOUNT 
command 

o Whether you initialized the disk as public or private 

In general, the disk is safeguarded, even against a user with 
MOUNT privilege, from being inadvertently made available for 
public use. 
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For Users with MOUNT privilege 

If you have MOUNT privilege, you can MOUNT a disk initialized as 
private. You can explicitly declare the usage with the /PRIVATE 
or /SHARE qualifier, but this is not required. You can also 
mount the disk with the /NOSHARE=n qualifier, to make the disk 
accessible only to job n (see the discussion for /NOSHARE [ =n ] ) . 

Table 15-3 summarizes the possibilities of the /PUBLIC, /PRIVATE, 
and /[ NO ] SHARE qualifiers. (If none of these qualifiers is 
specified, RSTS/E assumes /PRIVATE.) 



Table 15-3: The /PUBLIC, /PRIVATE, and /[NO] SHARE Qualifiers for the 



MOUNT 


Command 






INITIALIZE 


for disk was: 


Privileges | 
+ - - - - 


Public 


| Private 
■ + 



User does 
not have 
MOUNT 
privilege 



Any MOUNT returns an 
error . 



+ 



Only a MOUNT/NOSHARE 
succeeds . 



User has | MOUNT with /PUBLIC 

MOUNT | succeeds: the disk is 

privilege j accessible to all users. 

I 

| MOUNT with /PRIVATE or 

j /SHARE succeeds: the disk 

j is accessible to only 

j those users with an 

| account on the disk. 
I 

| MOUNT with /NOSHARE [=n] 

j succeeds; the disk is 

j accessible only to job n 

| (the user's job, by 

j default ) . 
I 

| MOUNT with no qualifier 

| succeeds as private disk: 

| the disk is accessible to 

j only those users with an 

j account on the disk: 

j RSTS/E displays a warning 

j message. 



MOUNT/PUBLIC returns an 
error. MOUNT with no 
qualifier or with 
/PRIVATE, /SHARE, or 
/NOSHARE succeeds. 
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/QUOTA 
/NOQUOTA 

Controls whether quota checking is performed when the disk is 
mounted. This qualifier applies only to Level 1.2 disks. The 
default is /QUOTA. 

/REBUILD 
/NOREBUILD 

Controls the rebuilding of a disk, regardless of whether the disk 
was initialized as read/write or read-only. A dirty disk is one 
that has been physically dismounted (removed from the drive) 
without being logically dismounted first by a DISMOUNT command. 

A DISMOUNT checks to see that no files are currently open on a 
disk. If files are open, the DISMOUNT does not succeed. If 
someone makes a mistake and physically removes a disk pack from a 
disk drive while programs are still using files on the disk, the 
usual "clean-up" operations that the RSTS/E monitor performs may 
not have occurred. For example, the monitor keeps the file 
SATT.SYS (the storage allocation table for the disk) in memory 
and updates it when files are added to or deleted from the disk. 
If someone physically dismounts a disk before the monitor has 
written SATT.SYS back to disk, the data in the old SATT.SYS will 
probably be incorrect. 

Rebuilding a disk requires MOUNT privilege. This operation 
performs necessary clean-up before the disk can be used again. 
Specifically, a rebuild operation: 

o Locates blocks that have been allocated to more than one 
file. The system displays a message listing the files to 
which such blocks have been allocated, and asks you to delete 
all but one of the files. 

o Deletes invalid directories. 

o Deletes all files that have the type . TMP , are marked for 
deletion, or have no accounting entry. 

o Builds a new storage allocation table (SATT.SYS), to show 
current file allocations (after deletions accomplished by 
rebuilding ) . 

o Zeroes all blocks that were in the old storage allocation 
table (SATT.SYS), but not in the new one. This is done as a 
security precaution: in case these blocks belonged to files 
with a protection code of <128> or higher (which are always 
zeroed when they are deleted) . 
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A MOUNT operation for disk automatically checks to see if the 
disk is dirty. If so, and you have MOUNT privilege, a rebuild 
occurs automatically, regardless of whether you specify /REBUILD. 
The following message appears to indicate that the disk is being 
rebuilt : 

Disk is being rebuilt - wait . . . 

However, if a user without MOUNT privilege tries to mount a dirty 
disk, RSTS/E displays the error message: 

?Disk needs rebuilding but you do not have MOUNT privilege 

The /REBUILD qualifier forces a rebuild on a disk. It lets the 
user with MOUNT privilege rebuild a disk that the system has not 
identified as "dirty." For example, some programs leave temporary 
files in the user's account, rather than deleting them before the 
program exits. Such a disk is not flagged as dirty. If you want 
to get rid of the temporary files on a disk, you can mount the 
disk using the /REBUILD qualifier. 

If you specify /REBUILD and the drive is write-protected, RSTS/E 
displays the following error message: 

?Can f t rebuild disk because device is write-protected 

If a user without MOUNT privilege specifies /REBUILD, RSTS/E 
displays the following error message: 

?You must have MOUNT privilege to rebuild the disk 

The /NOREBUILD qualifier overrides an automatic rebuild of a 
dirty disk. You may not want to take the time to rebuild the 
dirty disk. Or, the disk may have doubly allocated blocks, and 
you do not want to risk deleting them. In this case, you can 
mount the disk with the /NOREBUILD qualifier (thus granting only 
read-only access) and try to correct the situation. For example, 
you could use the COPY command to copy the files to new locations 
(where they do not contain doubly-allocated blocks) and try to 
sort out the situation from there. 
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If you have MOUNT privilege, and specify /NOREBUILD to mount a 
dirty disk, the disk is mounted restricted and read-only, and two 
warning messages appear: 

%Disk needs rebuilding 

%Disk is restricted and mounted no-share, read-only 

Thus, the disk is accessible only to the job that mounted it. 

When a user without MOUNT privilege specifies /NOREBUILD to mount 
a "clean" (rebuilt) disk, the mount succeeds and the disk is 
uneffected. 

/[ NO ] RESTRICT 



Indicates whether the disk is restricted. If you specify the 
/RESTRICT qualifier in the MOUNT command line, only users with 
DEVICE privilege can access the specified disk. The default is 
/NORESTRICT. 

/SHARE 
/NOSHARE [ =n ] 

Controls whether to limit disk access to: 

o Job n (/NOSHARE=n) 

o The job that mounted the disk (/NOSHARE) 

o Any user with an account on the disk (/SHARE) 

A disk mounted as shared is the same as a disk mounted as 
private. A user with MOUNT privilege can mount a private or 
public disk as shared or nonshared. 

If you do not specify /PRIVATE, /PUBLIC, or /[NO ] SHARE , then the 
default action is to mount the disk as private (shared). 

The /NOSHARE qualifier conflicts with either /PUBLIC or /PRIVATE. 
You can use /SHARE with either /PUBLIC or /PRIVATE; its presence 
in the same command line as the other two qualifiers has no 
effect. 
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/WRITE 
/NOWRITE 

Controls whether data can be written to the mounted disk. 

If you specify /NOWRITE, the disk is write-protected, which means 
that no users can write to the disk. The /NOWRITE qualifier 
protects files on the disk; they can only be read from, not 
written to. 

If you specify /WRITE, users who access the disk can write to it. 

When you do not specify /WRITE or /NOWRITE, the default depends 
on whether the disk was initialized as read/write or read-only, 
and whether the disk is clean or dirty. For disks initialized as 
read-only, the default is to give read-only access (/NOWRITE) to 
the disk. For disks initialized as read/write, there are a few 
more conditions to consider. If the disk is clean or can be 
rebuilt (/NOREBUILD was not specified), and the drive is not 
write - locked , /WRITE is the default. If the disk is clean and 
the drive is write-locked, /NOWRITE is the default, and the 
following warning message appears: 

%Device write protected 

If the disk is dirty and /NOREBUILD was specified, the disk is 
mounted read-only, noshare. 
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MOUNT Command for Tapes 

The MOUNT command for tapes verifies that the tape is properly loaded 
onto the unit and checks an ANSI tape for the label specified in the 
MOUNT command (ANSI tapes must have labels). You issue a MOUNT 
command after you have physically mounted a tape on a tape unit and 
placed it on line. 

If the device is restricted, you need DEVICE privilege to use the 
MOUNT command. 



+ 



+ 



Format 

MOUNT tape -device -name [:][ label ] 



Command Qualifiers 



Defaults 



/DENSITY=nnn See Discussion 

/FORMAT=argument See Discussion 

/[NO]WRITE See Discussion 

Prompts 

Device: device -name [: ] 
Label: label 

+ + 

Command Parameters 

tape -device -name [ : ] 

Specifies the physical or logical name of the drive on which the 
tape is physically mounted. If you do not specify a unit number 
with a physical device name, RSTS/E assumes unit 0. 



[label] 



This parameter is necessary only for ANSI tapes. If you try to 
mount an ANSI tape without specifying a label, RSTS/E prompts you 
for a label. 



A label is not required (and is ignored) when you mount a tape in 
DOS or foreign format. In this case, RSTS/E displays a warning 
message : 

%Label ignored 
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The label specifies the one- to six - character alphanumeric label 
written to the tape when it was initialized (see the INITIALIZE 
command description in the section "INITIALIZE Command for 
Tapes"). MOUNT then verifies that the label on the tape is the 
same as the one you specified in the MOUNT command. This process 
helps make certain that you have mounted the right tape. 

Command Qualifiers 

/DENS I TY=nnn 

Specifies the density in bits per inch (bpi) at which the tape 
will be read or written. You can specify 800 or 1600 if the tape 
drive supports it. Note that some kinds of drives support only 
one type of density; for example, the TU80 supports only 1600 
bpi . 

The density defaults to that which is currently on the tape. If 
this density is not supported by the tape drive, you get the 
error message: 

?Data error or incorrect density 

If you specify a density other than the one with which the tape 
was initialized, you get the error message: 

?Incorrect density or uninitialized tape 

/FORMAT=ANS I 
/FORMAT=DOS 
/FORMAT= FOREIGN 

Indicates whether the tape is in a standard format used by the 
RSTS/E operating system. The default format is the current 
system default (see SHOW SYSTEM, Chapter 14). 

The RSTS/E System User's Guide describes ANSI and DOS formats. A 
tape is FOREIGN if it is not in ANSI or DOS format. 

Note 

If you mount a tape with /FORMAT=FOREIGN, the 
program you use to read the tape must know what 
types of labels there are on the tape or be able 
to process any labels on the tape. 
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/WRITE 
/NOWRITE 

RSTS/E checks to see whether the tape is read/write (the write 

ring is present) or read-only (the write ring is not present). 

If the write ring is not present and you specify /WRITE, RSTS/E 
displays the following error message: 

?Device is write protected 

If the write ring is not present and you do not specify either 
qualifier, RSTS/E displays the following warning: 

%Device is write protected 
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Backing Up and Restoring Files 



Backing up disk files and accounts means copying the contents of the 
disk to another volume or set of volumes. Backing up disks is a 
precautionary measure to let you recover from the loss or destruction 
of valuable information. 

Most sites establish a policy and a schedule for regularly backing up 
disk files. This chapter provides the operating procedures for 
backing up both selected files and entire disks. 

It is just as desirable to back up information on private disks as it 
is to back up public disks. However, responsibility for backing up 
the files on private disks could be left to the individual owners of 
those files and disks. 

There are two kinds of backups of disk files: 

o Incremental, or partial backups 

o Full, or all-inclusive, backups 

In either case, the backup medium can be disk or magnetic tape. 
Incremental backups save only those files that have been modified 
recently. Periodic full backups are necessary to provide the basis 
for reconstruction of an entire disk. 

As a rule, incremental backups are undertaken more frequently than 
full backups. After consulting with users of the system, you decide 
how often to back up files and volumes and how long to retain backup 
media. 

Generally, you are responsible for setting up a schedule for backing 
up files and accounts, and for maintaining this schedule. The 
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following schedule for backing up public disk volumes on magnetic tape 
affords adequate protection of data for many installations: 

o Daily -- An incremental backup retained for seven days. This 
schedule requires seven daily tapes (or sets of tapes) that 
are rotated once a week. 

o Weekly --An incremental backup retained for four weeks. 
This schedule requires four weekly sets of tapes that are 
rotated once every four weeks. 

o Monthly -- An all-inclusive backup retained for a year. This 
schedule requires twelve monthly sets of tapes that are 
rotated once a year. 

Despite all precautions, there is always the risk of losing a file. 
Frequent backups and longer retention periods reduce this risk. You 
may also want to consider an off-site storage facility for the monthly 
save sets. 

You can perform full backups to magnetic tape or to another disk. 
Each has its advantages and disadvantages. The advantage of using 
magnetic tape for backups is the much lower media and storage cost, 
which may permit you to retain backups longer than keeping full 
backups on disk. 

However, there are several advantages to keeping copies on disk, which 
in some cases outweigh the higher cost. Disks exhibit better data 
reliability than magnetic tapes. Furthermore, disks tend to degrade 
less in storage. 



DCL Command Descriptions 

You can use two DCL commands: BACKUP and RESTORE. Files created by 
BACKUP are called Backup sets. A Backup set is a RSTS/E file that can 
be copied just like any other RSTS/E file. However, only BACKUP and 
RESTORE can interpret the data in a Backup set. The rest of this 
chapter describes BACKUP and RESTORE in detail. 

Note 

Because the BACKUP and RESTORE operations can use 
significant amounts of system resources, TUNE and 
INSTALL privileges are needed to use these commands. 
Additional privileges may be required to use certain 
qualifiers (for example, /ACCOUNT_DATA requires GACNT 
or WACNT privilege). If you want to delegate the 
responsibility for backing up certain files (for 
example, files on private disks) to the individual 
owners, they will need the necessary privileges. 
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BACKUP Command 

The BACKUP command creates a Backup set on a specified disk or 
magnetic tape from one or more RSTS/E disk files. Once the BACKUP 
utility determines the syntactical validity of the command 
specification and issues any warning message relative to either the 
command or the environment, BACKUP prompts with: 

Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>? 

At the prompt, enter the device name to write the Backup set to. The 
default is the output device you specified in the BACKUP command line 
You can use the /INITIALIZE and /NOINITIALIZE qualifiers to control 
initialization of the output device. 



Format 

BACKUP input - file - spec output-backup- set- spec 
Command Qualifiers Defaults 



/[NO ] ACCOUNTJDATA 
/BLOCK_SIZE=value 
/BUFFER_SIZE=n 

/CREATED= ( date/time or range) 
/MODIFIED= ( date or range) 
/DENSITY=n 
/END=[ NO] REWIND 

[ , [NO] DISMOUNT] 
/EXCLUDE[=( f ilespec list)] 
/[NO ] FILE_DATA 
/[NO]GROUP_SIZE[=n] 
/INCLUDE=( filespec list) 
/ 1 N__L AB E L = n ame 
/[NO] INITIALIZE 
/[ NO] LI ST_FILE[=f ilespec] 
/OUT_LABEL=name 
/[NO] PROMPT 
/[NO] QUERY 
/[NO] REWIND 
/[ NO ] VERI FY 

Prompts 

See Discussion 



/NOACCOUNT_DATA 

/BLOCK_SIZE=2048 

See Discussion 

ALL if neither /CREATED 

or /MODIFIED is present 

Highest available 

/END=DI SMOUNT 

None excluded 

/FILE_DATA 

/GROUP_SIZE=10 

None included 

Volume ID is not checked 

See Discussion 

/LIST_FILE=KB: 

See Discussion 

/PROMPT 

/NOQUERY 

/NOREWIND 

/NOVERIFY 



16-3 



BACKUP 



Command Parameters 
input - file - spec 

Identifies the files to be backed up. The file specification 
should be a standard RSTS/E file specification or a list of 
specifications separated by the plus (+) sign or a comma (/): 

dev: [p,pn]f ilename.typ, . . . 

You must specify the device. The PPN is optional and defaults to 
the user's current account. The file specification is optional 
and defaults to *.*. You can use standard wildcards. 

If you specify a filename but not the type, BACKUP assumes a * 
type. If the filename ends with a period, BACKUP assumes a null 
type. If you specify a file type, you must also specify a 
filename. 

output -backup- set- spec 

Identifies the device where the Backup set is to be created. The 
Backup set specification should be a standard RSTS/E device 
specification of the format: 

dev: [ PPN] filename . typ 

You must specify the device. PPN is optional and defaults to the 
user's current account. The file specification is optional and 
defaults to BACKUP. BCK. 

If the backup operation needs more than one volume in the Backup 
set, BACKUP prompts for subsequent volumes as follows: 

Please dismount volume 1 of Backup set backup- set -name 
Please mount volume 2 of Backup set backup- set -name 
Where can this volume be located <default>? 

Command Qualifiers 

/[ NO ] ACCOUNT_DATA 

If you specify /ACC0UNTJ3ATA and you have the necessary 
privileges ( GACNT or WACNT), BACKUP preserves all pertinent 
information about the account (quotas, password, privileges, and 
so on). RSTS/E uses this data to create accounts during a 
RESTORE. 

If you do not have accounting privileges (GACNT or WACNT), BACKUP 
only saves the attributes of your account that you have access 
to. In particular, you can not access the password attribute or 
restricted user attributes. 
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If you specify /NOACCOUNTJDATA, RESTORE cannot create accounts 
that do not exist in the Backup set. The default is 
/NOACCOUNTJDATA . 

/BLOCK_SIZE=value 

The /BLOCK_SIZE qualifier lets you select the block size used for 
the output Backup set. You must specify the value argument. 
Value can be in the range 2048 to 4080 bytes for tape, and 2048 
to 7680 bytes for disk. Further, the value must be a multiple of 
16 for tape and 512 for disk. 

If you do not specify /BLOCK_SI ZE , BACKUP uses 2048 bytes. 

Note 

Use of this qualifier can affect the performance 
and reliability of BACKUP. If you use large 
values, BACKUP operates faster and can store more 
data into a volume. Smaller values cause less 
data to fit into a given volume; however, they 
can increase the reliability (see the description 
of the /GROUP_SIZE qualifier). 

/BUFFER_SIZE=value 

The /BUFFER_SIZE=value qualifier controls the size of the dynamic 
region used by BACKUP. The valid range is 3 to 127. The value 
represents the number of K-words of memory to be used by BACKUP 
as buffer space. In general, the larger you specify n, the 
faster BACKUP performs. However, large numbers increase the 
system loading and resource usage, and can seriously impact other 
users. 

If /BUFFER__SIZE=value is omitted, BACKUP uses the minimum buffer 
space consistent with the other qualifiers. If the amount of 
memory requested is not available, BACKUP uses as much memory as 
possible and displays an informational message. 
/BU F F E R_S I Z E=MAX I MUM uses as much available memory as possible 
without displaying any message. 

/CREATED= ( BEFORE=date - time , AFTER=date - time ) 
/CREATED=date - time 

/MODI FI ED= ( BEFORE=date , AFTER=da te ) 
/MODIFIED=date 

The /CREATED and /MODIFIED qualifiers let you select the files to 
be backed up, as chosen by the file specification criteria (see 
the input - file - spec description), based on the creation date/time 
and/or revision date. If no file specification criteria exist, 
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these qualifiers apply to all files on the input volume for this 
operation. You can use /CREATED and /MODIFIED in conjunction 
with each other; they are not mutually exclusive. To be 
selected, a file has to satisfy all the criteria you specify. 

You can specify an exact date or range of dates for either 
qualifier. In the range format, each qualifier must take an 
argument of one or both of the subqualif ier s BEFORE or AFTER. 
The subqualif ier order in the argument is immaterial. 

The date-time argument is of the standard form (for example, 
dd-mmm-yy or yy.mm.dd and hh:mm A/PM or hh:mm). You must specify 
the date. If you do not specify the time, it defaults to 00:00. 
In addition, if you specify the time, you must be separate it 
from the date by a colon ( : ) . 

The following generic terms can be used in the subqualif ier : 

o TODAY -- meaning 00:00 on the current (system) date 

o YESTERDAY meaning 00:00 on the date previous to the 
current date 

When used with /CREATED, the generic terms also accept a time 
argument . 

If you do not specify either /CREATED or /MODIFIED, BACKUP 
selects all specified files for transfer to the Backup set. 

Note 

Files transferred by BACKUP retain their original 
creation and revision dates (that is, the dates 
on the source volume). You need DATES privilege 
to alter the Backup set dates. 



/DENSITY=n 

Specifies the recording density to be used on the output volume. 
The default value is the highest density available on the drive 
addressed. 

If you select a density that is not valid for the drive 
addressed, BACKUP displays a warning message: 

Density of <density> BPI not available, using <density> BPI 
instead 

You can only specify this qualifier for the first volume of a 
Backup set. Subsequent volumes are written at the same density 
as the first volume unless the addressed drive is different from 
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the first drive and the original density is not available 6n the 
addressed drive. In this case, the density is the highest 
density available for the addressed drive. 

/END= { REWIND | NOREWIND | DI SMOUNT | NODI SMOUNT } 

(For magnetic tapes only) REWIND causes the magnetic tape to be 
rewound to the load point and dismounted following successful 
completion of the BACKUP operation. NOREWIND causes the magnetic 
tape to remain positioned after the most recent Backup set. The 
default is NOREWIND. 

If you want the Backup set's device to remain mounted at the end 
of the BACKUP operation, specify NODISMOUNT in the command line. 
The default is DISMOUNT. 

/EXCLUDE=( f ilespec list) 

Lets you specify files that you want excluded from the BACKUP 
operation (for example, [ , 1 ] SWAP . SYS ) . You can include a list 
of file' specifications in the command line up to the maximum 
length of a DCL command line. 

/[ NO ] FILE_DATA 

Controls the transfer of file data during a backup operation. If 
you specify /FILE_DATA, the operation proceeds with actual file 
data being transferred to the Backup set from the RSTS/E volume. 
If you specify /NO F I L E__DATA , no files are written to the Backup 
set. Use /NO F I L E__D ATA with /ACCOUNT_DATA to back up only 
accounting data. 

The default is /FILE__DATA. 

/ [ NO ] GROUP__S I Z E [ =n ] 

Specifies the group size for XOR redundancy. The optional 
argument can be a decimal number from to 100. If you specify 
zero (equivalent to /NOGROUP_SIZE ) , BACKUP creates the Backup set 
without XOR redundancy. The default is /GROUP_SIZE=10 . 

The /GROUP__SIZE qualifier causes additional error recovery data 
to be stored in the Backup set. RSTS/E uses this information to 
recover from media errors during a RESTORE operation. 

The smaller the number, the greater the chance of recovering from 
data errors on RESTORE. Note that a smaller number also makes 
the Backup set larger. 

RESTORE can recover from one error in each group. So, for 
example, if you specify /GROUP_SIZE=20 , RESTORE can recover from 
one error in every 20 blocks. That is, with /GROUP_SIZE=20 , 
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RESTORE cannot recover from 2 or more errors every 20 blocks. 
Note that the /BLOCK_SIZE qualifier sets the size of each Backup 
set block. So, if RESTORE cannot recover 2 blocks of data, you 
lose 2 blocks of that size. In general, if something cannot be 
recovered, you lose less data with a smaller /BLOCK_SIZE. 

/INCLUDE=( f ilespec list) 

Lets you specify files or accounts that you want to be 
unconditionally processed. You can include a list of file 
specifications in the command line up to the maximum length of a 
DCL command line. 

Files in this set override those excluded with the /EXCLUDE 
qualifier . 

/IN_LABEL=name 

Specifies the name to be compared to the source volume ID. If 
you use this qualifier, the source volume ID must equal the 
specified name before the BACKUP can be perform the requested 
operation . 

/[NO] INITIALIZE 

Specifies the disposition of the output media prior to the data 
transfer operation and sets the default device specification in 
the Where can this volume be located <default>? prompt. 

For disk volumes, /INITIALIZE specifies that any file structure 
on the disk is to be disregarded and the volume is to be 
reinitialized with a RSTS/E file structure as if it were done 
with the INITIALIZE command. 

BACKUP also creates a nonuser account on the disk to hold the 
Backup set. That account is the account explicitly specified in 
the output specification, or implicitly specified as the current 
account of the caller. The pack cluster size is 16, the UFD 
cluster size is 16, and the file cluster size for the save set is 
set to the amount of free space on the disk divided by 100, 
rounded up to the next highest power of two. BACKUP does not 
define any accounting data for the created account. 

For magnetic tape volumes, /INITIALIZE specifies that BACKUP 
initializes the tape as a standard ANSI tape. 

You can only specify /NOINITIALIZE when doing a BACKUP to tape to 
create a new Backup set to be appended to the end of a tape 
containing other files (possibly other Backup sets). 
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/[NO]LIST_FILE[=f ilespec] 

Controls the production of a di rectory- like listing file that 
catalogs the sequence of events in the BACKUP operation. The 
file specification can be any valid RSTS/E file specification 
(wildcards are not allowed). The default is your terminal. 

You can use this qualifier to produce a listing of files in the 
Backup set, and then copy that file onto the backup volume. In 
this way, each backup volume has at least two files; the Backup 
set and a listing of the contents of the Backup set. 

/OUT_LABEL=name 

Specifies the desired name for the output volume ID. The 
resultant name can vary depending on the interaction between 
/OUT__LABEL and /[NO] INITIALIZE. 

Table 16-1 summarizes the possible outcomes of the interaction of 
/[NO] INITIALIZE and /OUT_LABEL during BACKUP. 



Table 16-1: /INITIALIZE and /OUTLABEL Interaction During BACKUP 



Qualifiers 
Specified 



Output Volume ID 



/OUT_LABEL=name 
/INITIALIZE 

/OUT_LABEL=name 
/NOINITIALIZE 



/INITIALIZE 
(only) 

/NOINITIALIZE 
(only) 



The specified name. 

The specified name; however, the operation 
is only successful if the output volume 
label has the same name. 

BACKUP supplies the name. 
The name is unchanged. 



/[NO] PROMPT 

Normally, the Backup utility issues a MOUNT prompt, for each 
BACKUP operation even if the Backup set's device is already 
mounted. You can eliminate the prompt for the first volume by 
including the /NOPROMPT qualifier in your command line. The 
default is /PROMPT. 
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/[NO] QUERY 

Causes BACKUP to prompt the user for each file that meets the 
selection criteria as to whether or not the file should be 
transferred. A Y[ES] response effects the transfer. A response 
of N[0] or pressing RETURN bypasses the file. Any other response 
causes the prompt to be reissued. The default is /NOQUERY. 

/[NO] REWIND 

Specifies the disposition of a magnetic tape Backup set volume 
before processing. The default is /NOREWIND. 

If you specify /REWIND, the tape is rewound and processing begins 
at the first Backup set on the volume or the named Backup set. 
If you specify /NOREWIND, processing begins at the next Backup 
set on the volume or the named Backup set. 

If the logical end-of-tape on the volume is found before locating 
the desired Backup set, BACKUP rewinds the tape and displays an 
error message at your terminal. 

/[ NO] VERIFY 

The /VERIFY qualifier specifies that a comparison operation is to 
be performed on all data transferred. This post-process 
verification reports the presence of any data differences. For 
any differences found, BACKUP displays the PPN, file name, and 
file type at the user's terminal. The default is /NOVERIFY. 

Restrictions 

Backup sets produced by the BACKUP utility are not bootable. 
They can be used to recover a dead system by booting a 
maintenance volume (for example, the distribution media) which 
contains the BACKUP code (see the RSTS/E System Installation and 
Update Guide ) . 

Examples 

Table 16-2 shows command formats for BACKUP operations and some 
of the qualifiers associated with a backup operation. 
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Table 16-2: BACKUP Quick Reference Table 



Command Action 



Command Example 



Save a file to a 
save set on tape 

Save a disk to a 
save set on tape 

Save a list of 
files to a save 
set on tape 

Full backup of a 
disk 

Incremental backup 
of a disk 
(following earlier 
full backup) 



BACKUP DRl : PAYROL.DAT MTO : PAYROL . BCK 



BACKUP/ACCOUNTJDATA - 

DUl :[*,*]*.* MM0.-1409MA.BCK 

BACKUP DR2 : PAYROL . DAT , - 

DUl : BENEFI . DAT , VAC ATI . DAT MTO : DAT17M . BCK 



BACKUP/LIST_FILE=928FEB. LOG/ACCOUNT_DATA' 
DRl: [*.*]*.* MMO : 928FEB.BCK 

BACKUP/LI ST_F I LE=1 1 5 MA . LOG/AC COUNT_DATA 
/CREATED=AFTER=4 - FEB -85:9:28- 
DR1:[*.*]*.* MM0:1015MA.BCK 
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RESTORE Command 

The RESTORE command restores a RSTS/E disk or subset thereof from a 
tape or disk Backup set. Once RSTS/E determines the syntactic 
validity of the command specification and issues any warning message 
relative to either the command or the environment, RESTORE prompts 
with : 

Please mount volume 1 of Backup set backup -set -name 
Where can this volume be located <default>? 

At the prompt, enter the device to use or press RETURN or LINE FEED to 
accept the default value. The default value is the device specified 
as the input parameter. If you specify /NOPROMPT, RESTORE omits the 
prompt message. 

If you are doing a partial restore, and you know what volume to start 
with, start with that volume (although you may start with any volume). 
RESTORE issues a confirmation message and starts with the volume you 
specify. Note that RESTORE may issue a warning message in this case. 

+ + 

| Format j 

| RESTORE input -backup- set - spec output - file - spec | 

| Command Qualifiers Defaults | 

| / [ NO ] ACCOUNT_DATA /ACCOUNT_DATA | 

j /BUFFER__SIZE=n See Discussion | 

| /CREATED= ( date/time or range) ALL if neither /CREATED | 

j /MODIFIED= ( date or range) or /MODIFIED is present | 

| /END= [ NO ] REWIND /END=DI SMOUNT | 



[ , [NO] DISMOUNT] 



/EXCLUDE=( f ilespec list) 

/[ NO ] FILE_DATA 

/INCLUDE=( f ilespec list) 

/IN__LABEL=name 

/[NO] INITIALIZE 

/[ NO] LI ST_FILE[=f ilespec] 

/OCCURRENCE=numbe r 

/[NO]OPTIMIZE[=( list ) ] 

/OUT_LABEL=name 

/PLACED_POSITION[=keyword] 

/[NO] PROMPT 

/[NO] QUERY 

/ [ NO ] REPLACE [ =QUERY ] 

/[NO] REWIND 



None excluded 

/FILEJDATA 

None included 

Volume ID is not checked 

See Discussion 

/NOLI ST_FILE 

/OCCURRENCES 

See Discussion 

See Discussion 

/PLACED_POSITION=INDEX 

/PROMPT 

/NOQUERY 

/REPLACE=QUERY 

/NOREWIND 
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+ 



+ 



Command Qualifiers (Cont.) 



Defaults (Cont.) 



/SELECT=( f ilespec list) 
/[ NO ] VERIFY 



See Discussion 
/NOVERIFY 



Prompts 



See Discussion 



+ 



+ 



Command Parameters 

input -backup- set- spec 

Identifies the device where the first volume of the Backup set is 
mounted. The Backup set specification should be a standard 
RSTS/E device specification of the format: 

dev: [ PPN] file - spec 

You must specify the device. PPN is optional and defaults to the 
user's current account. File-spec is optional and defaults to 
BACKUP. BCK. 

If the Backup set has more than one volume, RESTORE prompts you 
for subsequent volumes as follows: 

Please dismount volume 1 of Backup set backup- set -name 
Please mount volume 2 of Backup set backup-set -name 
Where can this volume be located <default>? 

output- file - spec 

Identifies where to put the files or accounts to be restored. 
The file specification should be a standard RSTS/E file 
specification of the format: 

dev: [ PPN] file - spec 

You must specify the device. PPN is optional and defaults to the 
account you logged in to. File-spec is optional and defaults to 
the file specif ication( s ) recorded on the Backup set. 

If you specify a PPN, RESTORE transfers all selected files to 
that account, even if the Backup set has multiple accounts, 
assuming you have sufficient privilege to create files in that 
account (GWRITE or WWRITE). If file name conflicts occur as a 
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result of the RESTORE (for example, TEMP.BAS exists in two or 
more accounts on the Backup set), the second and subsequent 
transfers require operator intervention unless you specify the 
/REPLACE qualifier. 

If you specify a wildcard PPN, RESTORE transfers all selected 
files to: 

o [*,*] -- the same accounts as on the Backup set 

o [n,*] -- forces the project number to n, uses the programmer 
number as on the Backup set 

o [*,n] -- forces the programmer number to n, uses the project 
number as on the Backup set 

If the accounts do not exist and you specify /ACCOUNT_DATA, 
RESTORE creates them with the same characteristics as they have 
on the Backup set, providing you have the necessary privilege to 
create the accounts (GACNT or WACNT) . 

Command Qualifiers 

/ [ NO ] ACCOUNT_DATA 

If you have sufficient privilege (GACNT or WACNT), this qualifier 
determines what level of information from a UFD is restored from 
a Backup set. 

Use /ACCOUNT__DATA to restore all accounting data that is recorded 
in the Backup set both to existing and to newly created accounts. 
Use /NOACCOUNT_DATA to inhibit the creation of accounts and 
restoration of UFD data. The default is /ACCOUNT_DATA. 

Note 

If an account already exists, RESTORE supersedes 
the accounting data when restoring to the 
original account. 

/BUFFER_SIZE=value 

The /BUFFER_SIZE=value qualifier controls the size of the dynamic 
region that RESTORE uses. The valid range is 3 to 127. The 
value represents the number of K-words of memory that RESTORE can 
use as buffer space. If you omit /BUFFER_SIZE=value , RESTORE 
uses the minimum buffer space consistent with the other 
qualifiers. 

The larger value you specify, the faster RESTORE performs. 
However, note that large values cause a greater impact to other 
users . 
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If the amount of memory you request is not available, RESTORE 
uses as much memory as possible and displays an informational 
message. If you specify /BUF F ER_S I Z E=MAX I MUM , RESTORE uses as 
much memory as possible; however, it does not display any 
message . 

/CREATED= ( BEFORE=date - time , AFTER=date - time ) 
/CREATED=date - time 

/MODI FIED= ( BEFORE=date , AFTER=date ) 
/MODI FIED=date 

The /CREATED and /MODIFIED qualifiers let you select the files to 
be restored, as chosen by the file selection criteria (see the 
output- file - spec description), based on the creation dates/times 
and/or revision dates. If no file selection criteria exist, 
these qualifiers apply to all files on the input volume to which 
you have access for this operation. You can use /CREATED and 
/MODIFIED in conjunction with each other; they are not mutually 
exclusive. To be selected, a file has to satisfy all the 
criteria you specify. 

You can specify an exact date or a range of dates for either 
qualifier. In the range of dates format, each qualifier must 
take an argument of one or both of the subqualif ier s , BEFORE or 
AFTER. The order of the subqualif iers in the argument is 
immaterial. If you specify both BEFORE and AFTER dates for 
either one of the qualifiers, the AFTER date must be earlier than 
the BEFORE date. 

If you do not use either /CREATED or /MODIFIED, all specified 
files are selected for transfer from the Backup set. 

Note 

BACKUP retains both the creation and revision 
dates as they were on the source volume for the 
files transferred if you have DATES privilege. 



/END= { REWIND | NOREWIND | DI SMOUNT | NODI SMOUNT ) 

(For magnetic tapes only) REWIND causes the magnetic tape to be 
rewound to the load point and dismounted following successful 
completion of the RESTORE operation. NOREWIND causes the 
magnetic tape to remain positioned after the most recent Backup 
set. The default is NOREWIND. 

If you want the Backup set's device to remain mounted at the end 
of the BACKUP operation, specify NODISMOUNT in the command line. 
The default is DISMOUNT. 
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/EXCLUDE=( f ilespec list) 

Lets you specify files that you want to be excluded from the 
RESTORE operation. You can include a list of file specifications 
in the command line up to the maximum length of a DCL command 
line. 

/[ NO ] FILE_DATA 

Controls whether file data is transferred during a RESTORE 
operation. If you specify /FILE_DATA, RESTORE transfers the file 
data from the Backup set to the RSTS/E volume. If you specify 
/NOFILE_DATA, RESTORE proceeds without restoring any of the 
specified files. The default is /FILE_DATA. 

If you have accounting (GACNT, WACNT) privileges, you can use 
/NO F I L E_DATA with the /ACCOUNTJDATA qualifier to restore only 
account information from a Backup set. 

/INCLUDE=( f ilespec list) 

Lets you specify files that you want to be unconditionally 
processed. You can include a list of file specifications in the 
command line up to the maximum length of a DCL command line. 

Files in this set override those specified with the /EXCLUDE 
qualifier . 

/IN_LABEL=name 

Specifies the name to be compared to the source volume ID. If 
you use this qualifier, the source volume ID must equal the 
specified name before the RESTORE operation can be performed. 

/[NO] INITIALIZE 

Specifies the disposition of the output media prior to the data 
transfer operation. 

The /INITIALIZE qualifier specifies that RESTORE should disregard 
any file structure on the disk and reinitialize the volume with a 
RSTS/E file structure as if it were done with the INITIALIZE 
command. 

RESTORE takes the characteristics from the source device summary. 
(If the device cluster size of the original volume is too small, 
the next higher valid cluster size is used for the output 
volume . ) 
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You can only specify /NOINITIALIZE when the RESTORE operation is 
from a Backup set to an existing RSTS/E disk. In this case, 
RESTORE places the files on the existing file structures instead 
of replacing them. 

/[NO]LIST__FILE[=f ile-spec] 

Generates a di rectory- like listing file, cataloging the sequence 
of events in the RESTORE operation. If you specify /LIST_FILE , 
you must include the file specification. It can be any legal 
RSTS/E file specification (wildcards are not allowed). The 
default is /LIST_FILE=KB : . 

/OCCURRENCE=numbe r 

Indicates the particular occurrence of a named Backup set to use 
when more than one Backup set of the same name exists on a 
magnetic tape. You must specify the argument which refers to the 
position relative to either the current tape position or the 
beginning of the tape depending on the use of /[NO ] REWIND . 

RSTS/E Backup sets are interchangeable with VAX Backup sets. 
However, VAX Backup set names can be greater than six characters, 
while RSTS/E looks at only the first six characters. Therefore, 
RSTS/E cannot distinguish between two VAX names that have the 
same first six characters (for example, ABCDEF and ABCDEFG) . To 
transfer ABCDEFG, you must use ABCDEF/OCCURRENCE=2 . 

The default is /OCCURRENCES ; the first occurrence of the named 
Backup set. 

/[NO]OPTIMIZE[=(list) ] 

The /[NO]OPTIMIZE=( list ) qualifier controls RESTORE's 
optimization of the directory structure. Two optimizations are 
available : 

o Directories can be extended to the size they were on the 
original volume 

o File cluster sizes can be increased to the maximum necessary 
to minimize calls to the file processor 

The /NOOPTIMIZE qualifier inhibits these optimizations. The 
/OPTIMIZE qualifier selects all optimizations. The default is 
/OPTIMIZE. 
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The /OPTIMIZE= ( list ) qualifier selects optimizations from the 
following: 

o CLUSTERSIZE Optimize cluster size 

o DIRECTORY -- Optimize directory size 

In general, you would want to perform these optimizations to 
increase overall system performance. However, if there is not 
much contiguous disk space available, you would not want to make 
all executable files contiguous. Similarly, if there is little 
free disk space, you would not want to optimize cluster sizes 
because this takes more disk space. 

/OUT_LABEL=name 

Specifies the desired name for the output volume ID. The 
resultant name can vary depending on the interaction between 
/OUT_LABEL and /[NO] INITIALIZE. 

Table 16-3 summarizes the possible outcomes from the interaction 
Of /[NO] INITIALIZE and /OUT__LABEL during RESTORE. 



Table 16-3: /INITIALIZE and /OUT LABEL Interaction During 
RESTORE 



Qualifiers 
Specified 



Output Volume ID 



/OUT__LABEL=name 
/INITIALIZE 

/OUT__LABEL=name 
/NOINITIALIZE 



The specified name. 



The specified name; however, the operation 
is only successful if the output volume 
label has the same name. 



/INITIALIZE 

(only) 

/NOINITIALIZE 
(only) 



The destination volume name is the same as 
the source volume name. 

The name is unchanged. 



/PLACED__POSITION[=keyword] 

Controls the placement of files that were marked as placed on the 
source disk. 
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The /PLACED_POSITION qualifier takes one of the following keyword 
arguments : 

o INDEX -- Place close to the storage allocation table and 
master file directory 

o MIDDLE -- Place close to the middle of the disk 

o ORIGINAL -- Place close to the original position on the 
source disk. 

The default is INDEX 

The rules for contiguity apply first and foremost; that is, 
RESTORE sacrifices placement in the interest of contiguity. The 
first sufficient contiguous space closest to the selected 
position is the first choice for positioning the file on the 
output volume. 

If no contiguous space of sufficient size exists on the output 
volume, then the first cluster(s) of the file are positioned as 
close to the original address as possible and the remaining 
clusters are positioned as required. 

/[NO] PROMPT 

Normally, the BACKUP utility issues a MOUNT prompt for each 
RESTORE operation even if the Backup set's device is already 
mounted. You can eliminate the prompt for the first volume by 
including the /NOPROMPT qualifier in your command line. The 
default is /PROMPT. 

/[NO] QUERY 

Causes RESTORE to prompt you as to whether each file that meets 
the selection criteria should be transferred. A Y[ES] response 
effects the transfer. A response of N[0] or pressing RETURN 
bypasses the file. Any other response causes RESTORE to reissue 
the prompt. The default is /NOQUERY. 

/[ NO ] REPLACE [ =QUERY ] 

The /REPLACE qualifier specifies that if a file being transferred 
in a restore operation already exists on the destination disk, 
the file from the Backup set replaces the one already on the 
disk. The /REPLACE=QUERY qualifier tells RESTORE to query the 
user before replacing a file. 

The /NOREPLACE qualifier specifies that if a name conflict 
occurs, the file transfer is not to take place under any 
ci rcumstances . 
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The default is /REPLACE=QUERY. 

/[NO] REWIND /- 

Specifies the disposition of a magnetic tape Backup set volume 
before processing. The default is /NOREWIND. 

If you specify /REWIND, the search for the Backup set begins at 
the beginning of the tape. The /NOREWIND qualifier means the 
search starts at the present position. 

If the logical end-of-tape on the volume is found before the 
desired Backup set, the tape is rewound and an error message 
appears at the terminal. 

/SELECT[=( f ilespec list)] 

Lets you select specific files from the input Backup set to be 
restored. You can use the /SELECT qualifier in conjunction with 
the /EXCLUDE qualifier and/or the /INCLUDE qualifier. If you use 
/SELECT in combination with other qualifiers, the file transfer 
candidates are chosen according to the following steps: 

1. All files on the volume for which the user has read access 
privilege are initially considered 

2. If you use the /CREATED or /MODIFIED qualifiers, only those 
files from step 1 which meet the time bracket criteria are 
considered 

3. If you use the /SELECT qualifier, only those files from step 
2 that match one of the /SELECT file specifications are 
considered 

4. If you use the /EXCLUDE qualifier, any files from step 3 that 
match one of the /EXCLUDE file specifications are removed 
from consideration 

5. If you use the /INCLUDE qualifier, RESTORE also considers any 
files meeting the inclusion criteria, provided that you have 
access to them. Note that RSTS/E does not consider the 
/CREATED, /MODIFIED, /SELECT, or /EXCLUDE qualifiers when 
processing the /INCLUDE list. 



/[ NO ] VERIFY 

The /VERIFY qualifier specifies that a comparison operation is to 
be performed on all data transferred. This post-process 
verification (for multi -volume Backup sets, all volumes are 
transferred before any volume is verified) reports the presence 
of any data differences. For any differences found, RESTORE 
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displays the PPN, file name, and file type at the user's 
terminal. The default is /NOVERI FY . 

Restrictions 

If you have sufficient privilege and you specified /ACCOUNT_DATA 
in the RESTORE command, and if the Backup set contains accounting 
information, BACKUP creates accounts if they did not previously 
exist. The account characteristics are the same as they were for 
the Backup set accounts. If the account already exists, BACKUP 
replaces the existing account characteristics. 

Restored volumes can be made bootable by HOOK.SAV if the file 
[ , 1 ] INIT. SYS is restored. See the RSTS/E System Installation 
and Update Guide for further details. 

Examples 

Table 16-4 shows command formats for RESTORE operations and some 
of the qualifiers associated with restore operations. 



Table 16-4: RESTORE Quick Reference Table 



Command Action 



Restore a file 
from a save set on 
tape 

Restore a disk 
from a save set on 
tape 

Restore a list of 
files from a save 
set on tape 

Restore a disk 
from a save set, 
if file exists, 
replace it. 



Command Example 



RESTORE/SELECT=PAYROL . DAT 
MTO : PAYROL . BCK DRl : * . * 



RESTORE MMO : 1 4 9MA . BCK DUl :[*,*]*. * 



RESTORE MTO : DAT17M . BCK - . 
/SELECT=pAYROL . DAT , BENEFI . DAT , VACATI . DA'B- 
DR2 :[*.*]*.* 

RESTORE/LI ST_F I LE=9 2 8 FEB . LOG- 
/ACCOUNT__DATA MMO : 928 FEB . BCK DRl :[*.*]*. * 



- - - - + 



- - + 
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Appendix A 
Managing the OPSER Spooling Package 



This appendix describes the OPSER-based spooling package. This 
package, like the new Print/Batch Services (PBS) package (see Chapter 
9), provides print and batch services. Most of the programs require 
SWCFG privilege to run. General aspects of related user programs, 
such as QUE and BATCH, are mentioned only briefly in this appendix. 
See the RSTS/E Utilities Reference Manual for a full description. 

The information presented here is for backwards compatibility only. 
New applications should use the PBS package. Move existing 
applications to PBS over time. PBS is: 

o More efficient 

o More flexible 

o Easier to manage 

o Handles DCL command files 

o Permits 8-bit and control characters on printers 

o Has job limits 
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Overview of Operator Services 

Operator services on RSTS/E involve the OPSER program and controlled 
programs in OPSER tables. Controlled (online) programs are: 

O QUEMAN 

O SPOOL 

O BATCH 

O RESTOR 

SPOOL and BATCH are spooling programs executing queued requests for 
either a line printer device or batch processor. QUEMAN is the queue 
manager program that passes queued requests to spooling programs and 
adds, updates, and deletes requests in the various queues. RESTOR is 
the optional system data restoring package that OPSER can control. 



OPSER Program Overview 

The OPSER program establishes interjob communication for all of its 
controlled programs. OPSER declares itself a message receiver with a 
system-wide identification that the controlled programs can recognize. 
When a controlled program starts, it declares itself a message 
receiver and supplies OPSER with certain data by means of the system 
message send/receive SYS call. OPSER places the program in its table 
of online jobs. See the RSTS/E Programming Manual for information 
about SYS calls. 

The identification that OPSER uses to communicate with online programs 
is called the message receiver identification, or simply, the receiver 
identification. Each identification exists in the system message 
receiver table and must be unique. Because of this uniqueness, only 
one copy of OPSER can be running on your system. Additionally, 
because all control and interjob communication of spooling jobs 
depends on OPSER, the operator services program must be running before 
any controlled jobs can be run. 

After it establishes initial interjob communication, OPSER makes it 
possible for an operator to interact with the controlled jobs. OPSER 
becomes the main interface between the operator and a system 
controlled program. Figure A-l shows the interaction among system 
controlled programs and the operator. 
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OPSER broadcasts information to the operator through a terminal 
designated as the Operator Services Console (OSC). For flexibility, 
the operator can make any keyboard line on the system the the OSC. To 
isolate the keyboard control from unwarranted tampering, OPSER itself 
does not need to be connected to the OSC, but may broadcast data on 
the physical keyboard line. Given that intermittent output is 
generated on the OSC, any other user (including the operator) could be 
logged into the system on that terminal. 

OPSER itself establishes a data base by which it controls online jobs. 
The data base resides in the OPSER package account OPSER$: and 
consists of three work files: 

o OPSERO.WRK -- Contains the current activities and message 
control directory tables 

o OPSER1.WRK Has the table of jobs on line to OPSER, the 
valid operator table, and tables of messages and legal 
commands 

o OPSER . LOG (which can be optionally renamed) -- Provides a 
history of operating activity 

To provide a nonvolatile data base during a time-sharing session, as 
well as continuity of operations between time-sharing sessions, OPSER 
stores the work file information on disk. Thus, if the system crashes 
or if OPSER alone unexpectedly terminates, the work files retain the 
most current processing information. Similarly, these files maintain 
data continuity from one time-sharing session to another. 

Whenever OPSER starts, it examines its files to determine whether 
entries in the online job and valid operator tables are still valid. 
Generally, OPSER retains active and valid entries and purges any 
entries that do not satisfy validation requirements. Upon restarting, 
therefore, OPSER attempts to preserve data from its previous 
operational state. 

The most convenient way to interact with OPSER is through the PLEASE 
program. PLEASE transmits commands to the OPSER program. OPSER 
checks that the sender is a valid operator and, if so, takes the 
requested action. Because of PLEASE, the operator need never directly 
run or attach to OPSER to perform operator functions on controlled 
jobs. See the section "Operator Communication Program: PLEASE" for a 
description of the PLEASE program. 
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Figure A-l: System Controlled Programs and Operator Interaction 



OPSER provides processing checks for online jobs. OPSER makes sure 
that all online jobs are still active, are still valid receivers, and 
are not hibernating. If any job is found to be hibernating, OPSER 
notifies the operator, who can attach the job to a terminal, remedy 
the cause of the hibernation, and/or restart the job. 



A-4 



Managing the OPSER Spooling Package 



OPSER interaction between a controlled job and the operator is 
recorded in one of three ways: 

o As a message -- A message is specifically formatted data to 
which OPSER assigns a sequence number for operator reference. 

o As an action request -- An action request is a special 

message that requires operator action and a response before a 
controlled job can resume processing. A request usually 
involves both performing an action (such as mounting a 
volume) and typing an answer (such as a device designator or 
program interrupt command) in direct response to the request. 

o As an information line -- An information line is a free form 
report of some internal operation performed. Information 
lines are typically not important to the operator function 
but merely provide a history of online events. 



QUEMAN Program Overview 

The QUEMAN program manages the system queue file OPSER? : QUEUE . SYS . 
The file retains all pending user requests and can store requests 
between time-sharing sessions. Users make requests of spooling 
programs through the QUE system program. To form a request for a 
user, QUE builds a message and sends it to QUEMAN, which updates the 
QUEUE. SYS file. 

QUEMAN maintains a table of online spooling programs in a work file, 
QUEUE. WRK, which is stored in the OPSER package library (OPSER$:). 
The program passes a queued request to a destination spooling job not 
currently busy with a request. As a spooling job completes a request, 
it notifies QUEMAN, which updates the queue and work files and checks 
for another request to pass to the spooling job. 

A spooling program typically handles one request at a time from 
QUEMAN. If no request is pending for a spooling program, the job 
enters an indefinite sleep state. The job is not awakened until the 
system queues a message for it. The message is the result of QUEMAN 
or OPSER transmitting data to the spooling job by means of the system 
message send/receive mechanism. 

To retain as much data as possible between time-sharing sessions, 
QUEMAN, like OPSER, examines its files upon restarting. After 
restarting, QUEMAN should resume processing with no loss of data from 
its previous run. QUEMAN examines the queue file structure and 
contents and reestablishes synchronization with any spooling jobs 
already on line and active. 
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SPOOL Program Overview 

The SPOOL program handles requests made for line printer output. 
SPOOL maintains dual communication paths: one with QUE MAN and one with 
OPSER. QUE MAN transmits queued requests to SPOOL. SPOOL interacts 
with QUEMAN only to notify it that a transmitted request is completed. 
Under normal circumstances, communication between SPOOL and OPSER is 
necessary only when an operator requires some special action (for 
example, aligning forms) of the spooling job. 

To identify output of a user's queued request, SPOOL prints heading 
burst pages. The program accesses the character generation file 
OPSER$ : CHARS . QUE to form the large, easily readable letters necessary 
to distinguish discrete requests and files within a request. 



BATCH Program Overview 

The BATCH program executes user requests by running a job for a user 
on a pseudo keyboard. By using a pseudo keyboard, BATCH eliminates 
the requirement for a physical terminal and relieves the user from 
typing by processing commands from a disk file. 

BATCH, like SPOOL, maintains dual communication paths: one with QUEMAN 
and one with OPSER. QUEMAN sends a message to BATCH to process a job 
request. BATCH interacts with QUEMAN only to notify it that a 
transmitted request is completed. BATCH typically depends on OPSER to 
form requests for operator action. To mount a user volume, for 
example, BATCH notifies OPSER. In turn, OPSER generates the request 
for the operator and processes the response from the operator. 

To process commands from a user-queued disk file, BATCH requires the 
command decoding file OPSER$ : BATCH. DCD. The BATCH. DCD file contains 
all the codes and parameters BATCH needs to decode user - specif ied 
control statements, perform syntax checking, and form a special 
intermediate file (BAnJmm.COM) of encoded BATCH commands. 

Both the SPOOL and BATCH programs charge processing (execution) time 
to the account under which the user queues the request. Overhead 
time, used to set up a request, is charged to the account under which 
the program is running. 



RJ2780 Program Overview 

The RJ2780 program is an optional layered product. Unlike BATCH and 
SPOOL, RJ2780 maintains only one communication path. QUEMAN sends a 
message to RJ2780 to process the next request (send a file). The 
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RJ2780 program can also send a message to QUE MAN requesting that SPOOL 
print a file that RJ2780 has received. RJ2780 has no communication 
with OPSER. 



Controlling RESTOR with OPSER 

An operator can control the RESTOR program through OPSER. If RESTOR 
runs detached, control through OPSER is the only means by which the 
operator can communicate with the RESTOR job. RESTOR, when detached, 
transmits all operator requests through OPSER and receives responses 
only from OPSER. 



Overview of OPSER Shutdown 

The entire operator services package is designed to terminate in a 
controlled manner using a "shutdown level." The defined shutdown level 
for each job determines the order in which OPSER terminates controlled 
jobs during system shutdown. The SHUTUP system program can be run so 
OPSER terminates controlled jobs with the lowest shutdown level first. 
OPSER informs each job at a certain level to complete processing at a 
logical end point. Only after OPSER shuts down all jobs at a given 
level does it proceed to shut down all jobs at the next highest level. 
SHUTUP itself does not proceed with final system shutdown until OPSER 
terminates all of its controlled jobs and kills itself. By using the 
controlled shutdown of OPSER, you can ensure continuity of processing 
user requests from one time-sharing session to another. 

Since RJ2780 does not communicate with OPSER, OPSER does not 
automatically shutdown RJ2780 as it does SPOOL and BATCH. 



Operator Services Program: OPSER 

The operator services program OPSER consists of two modules: 

o OPSER -- Establishes the initial conditions on start-up, 
checks initial conditions upon restart, and chains to the 
second module, OPRUN 

o OPRUN -- Executes commands and periodically checks status. 

Each module is stored in the OPSER Package Library (OPSER$:), has a 
protection code of <232>, and requires SWCFG privilege to run. For 
simplicity, this appendix refers only to one program, OPSER, which 
functionally includes the two modules. 
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You must run the OPSER program before the queue manager and spooling 
programs. If your applications need to use the OPSER package, you 
should start OPSER by including the RUN command in your system 
start-up command file. To start OPSER, type the following command: 

RUN OPSER$: OPSER 

OPSER V9 RSTS V9 TIMESHARING 

# 

At this point, the OPSER program performs a number of checks before it 
prints the number sign (#) prompt. The remaining portion of this 
section describes these initial program checks. Once you are familiar 
with this procedure, you can learn about OPSER operator commands, 
described in the following sections. 

If the you have SWCFG privilege, the program prints an identification 
line at the terminal to indicate it is running. If you do not have 
SWCFG privilege, OPSER displays an error message to indicate that you 
do not have access to OPSER. 

OPSER tests for the presence of its two work files (OPSERO.WRK and 
0PSER1.WRK) in OPSER$:. If the work files are not present, OPSER 
prints the warning message: 

%OPSER files not found - will initialize . . . 

OPSER then initializes all its tables. At this point, the valid 
operator table has a single entry that allows the current user (on any 
terminal) to communicate through OPSER. If ERRCPY is active, the 
online job table has ERRCPY as its only entry. 

When OPSER finds the work files, it makes sure that it has write 
access to the files. Should another job have write access to the 
files, OPSER prints the following warning message and terminates: 

%OPSER does not have write privileges to its files 

To allow OPSER to gain write access, the operator must terminate the 
job currently having write access and run OPSER again. 

The program performs further special processing for currently existing 
work files. The processing makes sure of data integrity in case OPSER 
is being restarted after a system crash. A check is made of the 
entries in the online job and valid operator tables. 
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For each entry in the online job table, OPSER checks the following 
conditions : 

o The job number indicated in the entry must be active on the 
system. 

o The receiver identification in the entry must exist in the 
system message receiver table for that job number. 

o The account in the entry must be a valid account number. 

An entry for an inactive or otherwise illegitimate job is removed from 
the online job table. For each active and legitimate job, OPSER 
requests retransmission of the job's last message when processing 
begins. When processing begins, OPSER generates a command to display 
the online job table. 

OPSER checks the entries in the valid operator table. Additional 
actions take place depending on whether jobs found in the online job 
table are active. If the online job table has no active jobs and a 
meaningless entry is in the valid operator table, OPSER clears the 
table and sets initial conditions. The resulting operator table has 
one entry that allows, as valid operators, the current user from any 
keyboard. If the online job table has an active job, the program 
merely removes those entries that have no meaning from the valid 
operator table. To signal a change in the current table, OPSER 
creates an internal command to print the valid operator list when 
processing begins. 

After processing of the work files is complete, the program attempts 
to declare OPSER as a receiving job. If the declaration fails, the 
program prints the error message: 

?OPSER cannot declare itself a receiver 

This message indicates that another copy of OPSER has been run and 
must be properly terminated to allow the current copy to run 
successfully. 

OPSER establishes the current keyboard as the Operator Services 
Console (OSC) and a file named OPSER . LOG as the default log file. 
OPSER . LOG is optional, but OPSER uses it until an explicit command 
closes it or assigns another log file. When OPSER begins normal 
operation, it executes any internally generated commands to list 
online jobs and valid operators. After executing the commands, OPSER 
is ready to accept data sent to it by any program. OPSER prints the 
number sign (#) character to show that it is ready to accept commands. 
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OPSER Operator Commands 

You can abbreviate a valid OPSER command to three or more characters 
and separate the command from any operands by a space character. No 
embedded spaces are allowed within a command. Delimiters within the 
text of the operands are the semicolon (;) and colon (:) characters 
and must be present to delimit elements of text. Throughout the 
following discussion, note that square brackets enclose optional 
items . 

Table A-l summarizes the commands and formats. Note that the 
circumflex (" ) character marks the location of a required space. 



Table A-l: OPSER Commands 



Command Name 


| Syntax and Meaning 


ANSWER 




ANS[WER]" msgnumber : text 

conveys tne text loiiowing une cuion as a tespcjuse 
to an action request denoted by message number. 
Also deletes the action request. 


CHANGECONSOLE 




CHA[ NGECONSOLE KBn : 

Changes the operator services console to the 
keyboard unit designated by n. The unit should be 
on line but need not be free. It must also be set 
for /BROADCAST (see Chapter 8). 


DELETE 




DEL [ ETE ]~ msgnumber 

Deletes from an OPSER internal table an unanswered 
action request denoted by its message number. 

DEL [ ETE ]~ #m[ :n] 

Deletes the n oldest (from 1 to 32) action 
requests for a given job. The command requires the 
number sign (#), the number (m) of the sending 
job, a colon (:), and the number (n) of requests 
to delete. 


DETACH 




DETfACH] 

Detaches the OPSER program from its keyboard, 
after which the operator can run PLEASE to 
communicate with OPSER. 
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Table A-l: OPSER Commands (Cont.) 



Command Name | 
+ 



Syntax and Meaning 



EXIT 



INTERRUPT 



LIST 



LOGFILE 



EXI [ T] 

Closes the log file and work files, removes OPSER 
from the system message receiver table, and 
terminates the program. If the job is attached, 
the program returns you to the keyboard monitor 
prompt. If detached, the program broadcasts a 
message to the system console terminal ( KBO : ) and 
kills itself. 

INTERRUPT]" rcvridrtext 
INT[ ERRUPT]" #n: text 

Sends the unsolicited text to an on-line job 
specified either by its message receiver 
identification or by #n (where n is the number of 
the job under which the on-line program is 
running). The LIST JOBS command listing gives job 
numbers and receiver identifications. 

LIS [ T ]~ JO[BS] 

LIS [ T ]~ 0P[ ERATORS ] 

Prints a listing of all jobs on line to OPSER or a 
listing of valid operator accounts and keyboards. 

LOG[ FILE T [ file] ; [msglevel ] 

Establishes, as the OPSER log file, the specified 
file or device and sets the message level to the 
value specified. If a file or device is not 
specified, a semicolon followed by a level simply 
changes the message level of the open log file. If 
neither a file nor message level is specified, 
OPSER closes the current log file and records 
nothing more. 

LOG [FILE]" [file] ;AL[L] 

ALL records all messages and action requests. 

LOG [ FILE ]" [file] ; RE [QUESTS] 

REQUESTS records only action requests. 

LOG [FILE]" [file] ;NO[NE] 

NONE records no messages, action requests, or 
OPSER information lines. 
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Table A-l: OPSER Commands (Cont.) 



+ + 

| Command Name | 
+ - - + 



Syntax and Meaning 



MESSAGE | MES[ SAGE]" [ level ] 

Sets the level of messages for the OSC. The level 
controls what types of messages are printed at the 
OSC. If no level is included in the command, an 
error is generated. 

MES [ SAGE ]~ AL [ L ] 

ALL includes all messages, action requests, and 
OPSER information lines. 

MES [ SAGE]" RE [QUESTS] 

REQUESTS includes only action requests and 
information lines and excludes messages. 

MES [ SAGE ] * NO [ NE ] 

NONE means that nothing is printed on the OSC. 
(See the section "Message Types" for a discussion 
of message level.) 

OPERATOR I OPE [ RATOR ] " KBn : [ p , pn ] 

Updates the valid operator list with the 
designated keyboard unit and account combination. 
The asterisk (*) character can replace the 
keyboard unit, project number(p), and programmer 
number (pn) to include all of that element. 

OPE [ RATOR ]" - KBn :[ p , pn ] 

If a minus (-) sign precedes the specification, 
that specific element is deleted from the list. 

RETYPE I RET[ YPE]~ msgnumber 

Reprints, at the requesting terminal, an 
unanswered action request denoted by its 
associated message number. 

RET[ YPE ]" [#n[ :n] ] 

Several unanswered action requests can be printed 
by giving the number of the sending job. If :n is 
given with the job number, the n oldest (from 1 to 
32) action requests are printed for that job. 



Note 



Entering an account that does not have SWCFG 
privilege in the OPSER operator table with the 
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OPERATOR command allows anyone logged in to that 
account access to all accounts. You must use caution 
when deciding which accounts you place in the OPSER 
operator table. 



Message Types 

OPSER displays two types of information on the Operator Services 
Console (OSC): messages and action requests. Messages are simply 
informative. For example, a message might tell you that a control 
file has been queued for batch processing. Action requests require an 
operator to perform some action before the job continues (for example, 
mounting a tape). 

The MESSAGE command lets you define the level of information displayed 
at the OSC. For example: 

o MESSAGE ALL - - You want both messages and action requests 
displayed at the OSC. 

o MESSAGE REQUESTS -- You want only action requests displayed 
at the OSC. Messages are held in a table until you specify 
MESSAGE ALL. 

o MESSAGE NONE -- You do not want any messages displayed at the 
OSC. Messages and requests are held in a table until you 
specify MESSAGE ALL or MESSAGE REQUESTS and then the RETYPE 
command. 

When OPSER starts, the default is MESSAGE ALL. If you suspend the 
display 'of messages, or messages and requests, by typing MESSAGE 
REQUESTS or MESSAGE NONE, the suspended items are held in a table. 
The table can hold a maximum of 32 messages or requests. (The actual 
number held depends on the length of the messages and requests.) If 
OPSER receives a message or request after the table is full, the new 
message or request is added to the table, and the oldest message or 
request is deleted. 

Thus, you should not suspend message printing for long, or you may 
lose messages and requests. When you want to see messages and 
requests again, type MESSAGE ALL. Then use RETYPE to print the 
messages and requests currently held in the table. 

If you see "Message Table Full" displayed at the OSC, it means that a 
message was received, and the table was full. Some unknown number of 
old messages and requests had been lost while MESSAGE NONE or MESSAGE 
REQUESTS were in effect. 
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To help you distinguish between messages and action requests on the 
OSC, output appears in distinct formats. A single TAB character 
denotes message text; two TAB characters denote action request text. 

Message requests have the format: 

MESSAGE nnnnn : date time JOB:NN KB: MM jobname [p,pn] 

text 

If the first character of the message text is a question mark (?) 
character, the words FATAL MESSAGE replace MESSAGE in the 
identification line. 

Action requests have the format: 

REQUEST nnnnn : date time JOB:NN jobname [p,pn] rcvrid 

text 

In an action request, the first character of text is a CTRL/G (BEL) 
that sounds a bell in the terminal to alert the operator. Table Ar2 
summarizes the contents of messages and action requests. 



Table A-2: OPSER Message and Action Request Contents 



Item Meaning 


nnnnn 


Sequence number of message starting at 1 and incremented 
by 1 during processing; use with the ANSWER command to 
respond to a specific action request. After restarting 
with currently existing work files, OPSER rounds the 
last assigned sequence number up to the next multiple of 
10. This number is the next assigned sequence number. 


date 


Current system date. 


time 


Current system time of day. 


JOB : nn 


Job number under which sending program is running; use 
it, preceded by the number (#) sign, to refer to the job 
in an INTERRUPT, DELETE, or RETYPE command. 


KB :mm 


The keyboard number of the job that sent the message. 
The KB:mm field is displayed as DET if the job was 
detached, and as KB:?? if OPSER is unable to determine 
the keyboard number. Typically, the KB:?? message 
appears when the job has terminated. 
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Table A-2: OPSER Message and Action Request Contents (Cont.) 



+ 



Item 



jobname 



[P/Pn] 



rcvr id 



Meaning 



Name of the program that an online sending job is 
running; this name is printed for information purposes. 
OPSER prints six question marks, ??????, in place of the 
jobname if it is unable to determine the jobname. 
Typically, the ?????? message appears when the job has 
terminated . 



Pro ject -programmer number (PPN) under which the sending 
online job is running. 

For action requests only. The message receiver 
identification given to the job when it is started. The 
identification can be standard ( LPnSPL for the SPOOL 
program or BAnSPL for the BATCH program) or can be 
optional (as specified in the NAME start-up switch for 
SPOOL or BATCH). Use the receiver identification with 
the INTERRUPT command to refer to the spooling program. 



+ 



An action request is the result of a spooling job's requesting 
interaction with the operator: the spooling job sends a message to 
OPSER. The spooling job performs no further processing until operator 
action is taken or until the condition that generated the action 
request is satisfied. OPSER broadcasts action requests on the OSC 
unless the message level is set to NONE. 

To respond to an action request, the operator uses the ANSWER command. 
Because OPSER usually runs detached, an operator can run PLEASE at 
valid operator terminals to send the response to OPSER. The ANSWER 
command requires a message number to identify the action request to 
which the operator is responding. 

OPSER sends the text in the ANSWER command to the spooling program and 
deletes the action request. If the response satisfies the request, 
the program resumes processing. If the response does not satisfy the 
request, the spooling program still expects an appropriate response. 
The operator must then send such a response by means of the INTERRUPT 
command (see the section "Operator INTERRUPT Command"). 
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Valid Operator and Online Job Lists 

The LIST command displays data concerning the valid operator list or 
the online job table maintained by OPSER: 

o LIST OPERATORS displays the keyboard number and PPN 

combinations currently defined as valid operators. The 
OPERATOR command updates the valid operator list. Initially, 
only users with SWCFG privilege can update the valid operator 
list. 

o LIST JOBS prints the header ONLINE JOB and then prints data 
concerning online jobs in the following format: 

#n [p,pn] 'rcvrid' SL=n 

Table A-3 describes the items in the online job list. 

Table A-3: OPSER Online Job List 



Item 



Meaning 



#n | The job number under which the online program is 

running . 

[p,pn] | The PPN under which the online job is running. 

'rcvrid' I The message receiver logical identification used to 
identify the online program in INTERRUPT commands. 

SL=n | The OPSER shutdown level used when SHUTUP notifies 

OPSER to terminate spooling operations in an orderly 
fashion. 



+ 



+ - 



+ 



The job data listed is important to the operator. For example, 
certain OPSER commands require either a receiver identification or job 
number to communicate with a spooling program. 



Operator INTERRUPT Command 

The INTERRUPT command sends unsolicited messages and special commands 
to spooling programs. OPSER accepts any text in the INTERRUPT command 
and sends it to the destination job. Only the destination job 
interprets the text. If a response to an INTERRUPT command is 
generated, it is displayed on the OSC. Tables A-6, A-12, and A-15 
summarize special text interpreted by spooling programs as commands. 
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The INTERRUPT command allows an operator to control and to monitor 
spooling programs. Each spooling program recognizes commands that can 
be divided into three sets: 

o Commands that have no direct effect on how the program itself 
processes a request queued by a user. Included in this set 
of commands are PAUSE, CONTINUE, NOTICE, LAST, and STATUS. 
They allow the operator to control the program in general and 
to gain information about the program. 

o Commands that do have a direct effect on program operation 
but are uniform for all spooling programs. END, ABORT, and 
OFFLINE represent this type of command which directly 
influences the job. 

o Commands that are unique to the individual spooling program. 
A command for forms control on a line printer is an example. 



OPSER Start-Up Procedure 

Use commands in the system start-up control file to start the OPSER 
program. See "System Start-Up Command File: START.COM" in Chapter 3 
for information about creating a start-up control file. This section 
describes the commands you should include in that start-up file. 

The following is a typical sequence of start-up file commands to start 
OPSER: 

$ RUN 0PSER$:0PSER 

LOG OPSER? :0PSER.L0G;ALL 

CHA KBO: 

MESS ALL 

OPER KB* : [ 1 , 2 ] 

DETACH 

The LOGFILE, CHANGECONSOLE, MESSAGE, OPERATOR, and DETACH commands 
establish initial operating conditions for OPSER. The LOGFILE and 
MESSAGE commands set conditions normally established as defaults and 
are shown for clarity. An explanation of these commands follows: 

o The LOGFILE command retains the file 0PSER$ : OPSER . LOG with a 
message level of ALL. As a result, all messages, action 
requests, OPSER information lines, and operator responses are 
written to the file to provide a complete historical 
reference . 

o The terminal on which OPSER starts is automatically defined 
as the OSC. You can change this definition by placing the 
CHANGECONSOLE command in the start-up procedure. Any valid 
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operator may also alter the assignment of the OSC. It is 
most convenient to keep keyboard unit as the OSC because, 
regardless of the number of logins currently allowed on the 
system, the operator can always use the system console 
terminal to communicate with OPSER. 

o The MESSAGE command specifies that all messages, action 

requests, and OPSER information lines are printed at the OSC. 
Normally, the operator is concerned only with action 
requests. If the operator is concerned with any unanswered 
action request, the RETYPE command can be issued. In 
addition, the log file can be closed with the LOG command and 
printed at any time to recover recorded information. 

o The OPERATOR command updates the valid operator list with 
user [1,2] on any keyboard. Allowing the operator to 
communicate from any terminal on the system gives flexibility 
to those who are performing operator functions. 

o The DETACH command causes OPSER to detach itself from the 
terminal on which it is running. At the start of 
timesharing, this terminal is usually the system console 
terminal ( KBO : ) . While OPSER runs detached, it is immune 
from tampering by unauthorized users. The operator can 
communicate with OPSER through the PLEASE program. 



OPSER Action Under Various Start-Up Conditions 

OPSER start-up actions depend on the way OPSER last terminated: 

o When OPSER runs after you have shut down operator services in 
an orderly fashion through SHUTUP, a normal start-up 
procedure occurs. When shutting down in an orderly fashion, 
OPSER removes all entries from its online job table and 
closes all files properly. On restarting, OPSER finds all 
data valid. The online job table is empty, and entries in 
the valid operator table are legal and therefore retained. 

o When OPSER starts after a system crash, it may find entries 
in its online job table. Because OPSER starts before other 
online jobs, none of the jobs in the table is active; 
therefore, the program clears the entries from the table. If 
any entries in the valid operator table are illegal, OPSER 
clears that table and sets one valid operator entry: the 
current user from any keyboard. 

o When OPSER starts after an unexpected termination, it may 

find entries in its online job table for jobs still active on 
the system. In this instance, the program sends a command to 
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each active job having an entry in the online job table. The 
command requests the job to retransmit the last message it 
sent to OPSER. OPSER does not wait for a response. If any 
job in the online job table does not meet OPSER' s integrity 
checks, OPSER removes its entry from the table (takes the job 
off line) and generates an internal LIST JOBS command. OPSER 
also scans the entries in the valid operator table. If any 
entry is illegal, the program removes it. If OPSER removes 
any entry, it generates an internal LIST OPERATORS command. 



Queue Manager Program: QUEMAN 

The queue manager program QUEMAN maintains the file of queued requests 
(QUEUE. SYS in the OPSER$: account and communicates with spooling 
programs to execute queued requests. Queue management involves two 
modules stored in the OPSER Package Library: QUEMAN and QUMRUN. Both 
modules have a protection code of <232>, and require SWCFG privilege 
to run. 



QUEMAN : 
o 
o 
o 

QUMRUN : 
o 
o 



Sets initial conditions on starting 
Checks initial conditions after restarting 
Chains to QUMRUN 

Executes commands 
Manages the queues 



For simplicity, the documentation refers only to one program, QUEMAN, 
which functionally includes the two modules. 

The QUEMAN program runs only if the job has SWCFG privilege and the 
OPSER program is running (that is, only if the name OPSER is in the 
system table of message receivers). Starting QUEMAN is a prerequisite 
to starting the spooling programs. To start QUEMAN, type the 
following command while logged into the system under an account SWCFG 
privilege : 

RUN OPSER$ : QUEMAN 

QUEMAN V9 RSTS V9 TIMESHARING 
STARTED AT: 01:52 PM ON 03 -MAR- 85 

If you do not have SWCFG privilege, the system displays an error 
message to indicate that you do not have access to QUEMAN. 
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If the job has enough privilege, the program prints its identification 
line and start-up lines and begins preliminary error checking. 

QUE MAN tests for the presence of OPSER which must be started before 
QUEMAN can run. If OPSER is not running, QUE MAN prints an 
informational message and terminates: 

QUEMAN cannot run without 'OPSER' active 



QUEMAN opens the files QUEUE. WRK, OPSERl.WRK, and QUEUE. SYS in the 
OPSER$ : account. If QUEUE. WRK does not exist, the program prints the 
following informational message and creates the file: 

'QUEUE. WRK' not found - will initialize 

If OPSERl.WRK does not exist, the program prints the following 
informational message and terminates: 

OPSERl.WRK not found can't run 

To recover, the operator must start the OPSER program before starting 
QUEMAN. If QUEUE. SYS does not exist, the program creates and 
initializes it. QUEMAN signals this action by generating the 
informational message: 

No queue file found -- will initialize 

If QUEUE. SYS exists, QUEMAN makes sure that it has write access to the 
file. If another program has write access to the QUEUE. SYS file, 
QUEMAN generates the following message: 

Queue file opened by another program 
Try again (Y/N) <N>? 

The operator must determine which job has the file QUEUE. SYS open and 
must terminate that job. If you type Y in response to the question, 
QUEMAN retries the open operation. Typing N terminates QUEMAN. 

When the OPEN operation successfully gains write access to QUEUE. SYS, 
QUEMAN declares itself a message receiver on the system. If QUEMAN is 
already declared by a different job, the program prints the message: 

QUEMAN cannot declare itself as a receiver ... can't run 

The operator must terminate the other job so it is removed from the 
message receiver table. 

To make sure that the previous QUEMAN job closed the currently 
existing QUEUE. SYS file properly, the program checks a flag value in 
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the file. If the flag is not properly set, the program prints the 
following informational message: 

Queue file not closed properly now checking data for consistency 

A later informational message signals that all integrity checks were 
successful: 

Queue file data checked for consistency 

If the flag is properly set, QUE MAN performs consistency checking but 
does not print any messages unless it finds problems. If any problems 
are found, QUE MAN generates the following informational messages: 

Queue file data inconsistent - will initialize 
Initialized 

The INITIALIZED message indicates that QUEMAN has set all entries in 
the QUEUE. SYS file to their initial conditions and has removed all 
queued requests from the queues. See the section "QUEMAN Consistency 
Checking" for a description of the queue file consistency checks 
QUEMAN performs. 

After completing all initial checks, QUEMAN prints the number sign (#) 
prompt indicating its readiness to accept a start-up command or 
switch . 



QUEMAN Start-Up Commands and Switches 

Table A-4 lists the start-up commands that QUEMAN recognizes. 



Table A-4: QUEMAN Start-Up Commands 



Command 



Syntax and Meaning 



DETACH 



DET[ ACH] 

Detaches QUEMAN from the terminal. You should run 
QUEMAN detached. 



INITIALIZE 



INITIALIZE] 

Sets all the entries in the QUEUE. SYS file to their 
initial conditions and sets initial conditions for 
the spooling queues. Any currently queued requests 
are lost. 
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Before QUEMAN executes the INITIALIZE command, it checks its online 
spooler table. If the table has an entry for a spooling job, QUEMAN 
prints the following informational message: 

Spoolers on line -- can't initialize 
# 

QUEMAN also recognizes start-up switches. One or more switches may 
appear following a command or may appear alone on a line in response 
to the prompt. 

Table A- 5 lists the start-up switches that QUEMAN allows. 



Table A-5: QUEMAN Start-Up Switches 



Option 



Syntax and Meaning 



PRIORITY | /PRI [ORITY] :nnn 

Sets the job priority to nnn, where nnn can be from 
-120 to +120. Without the switch, the program 
automatically sets the priority to 0. You must have 
TUNE privilege to specify this qualifier. 



RUNBURST | /RUN [ BURST ]: nnn 

Sets the job run burst to nnn, where nnn can be from 1 
to 127. Without the switch, the run burst value 
currently assigned is used. You must have TUNE 
privilege to specify this qualifier. 



If any data entered in response to the number sign prompt are not 
valid commands or options, QUEMAN prints the following informational 
message: 

Invalid response -- text 

The text is the data entered. The program prints the # prompt again. 

To detach QUEMAN, the operator types the DET command in response to 
the prompt. For example: 

# DET 

Detaching ... 

The program then prints the DETACHING message and detaches itself from 
the keyboard. Note that you should always run QUEMAN detached. 
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While detached, the job receives commands from the operator through 
OPSER (see the following section). At no time should the operator 
enter CTRL/C to the QUEMAN program; this may corrupt the QUEUE. SYS 
file. 



QUEMAN Interrupt Commands 



QUEMAN recognizes interrupt commands that allow an operator, through 
the INTERRUPT command of OPSER, to get information on queue manager 
processing and to control program operation. 



Table A-6 summarizes these interrupt commands. 



Table A-6: QUEMAN Interrupt Commands 



+ + 

| Command | 
+ + 



+ 



Option and Meaning 



+ 



DIS [ABLE ] 



QUE[UING]<text> 



SPO[OLING]<text> 
ALL<text> 

Disables QUEUING or SPOOLING or both operations with 
the ALL switch. When you specify DISABLE QUEUING, the 
program QUE stops sending messages to QUEMAN and stops 
listing the queue. Any jobs already sent to QUEMAN are 
processed. If you specify DISABLE SPOOLING, QUEMAN 
prevents any further jobs from being sent to any 
spooler. Jobs sent to a spooler prior to the DISABLE 
command are processed to completion. Specifying 
DIS[ ABLE] ALL tells QUEMAN to terminate both QUEUING 
and SPOOLING. You can include a message to the user 
while specifying the DISABLE command. Type the 
command, the switch, and then a space followed by the 
message. After QUEMAN processes the command, it prints 
the <text> message in one of the following formats: 

o Further QUEUING DISABLED <text> 

o Further SPOOLING DISABLED <text> 

O Further QUEUING AND SPOOLING DISABLED <text> 

If you ignore the <text> field, QUEMAN prints the 
default text, "by operator." The message appears when 
you try to queue a file. 



A-23 



Managing the OPSER Spooling Package 



Table A-6: QUEMAN Interrupt Commands (Cont.) 



Command 



Option and Meaning 



ENA[BLE] | QUEfUING] <text> 
SPO[OLING]<text> 
ALL<text> 

Enables QUEUING or SPOOL 
the ALL option. When you 
program QUEUE begins to 
starts listing the queue 
SPOOLING, QUEMAN begins 
Specifying ENABLE ALL te 
QUEUING and SPOOLING fun 
to send messages to the 
switch, and then a space 
message. After QUEMAN pr 
the message in one of th 



ING or both operations with 

specify ENABLE QUEUING, the 
send messages to QUEMAN and 
. If you specify ENABLE 
to send jobs to the spoolers, 
lis QUEMAN to start both the 
ctions. Use the <text> field 
user. Type the command, the 

followed by the text of the 
ocesses the command, it prints 
e following formats: 



O QUEUING ENABLED - <text> 

O SPOOLING ENABLED - <text> 

O QUEUING AND SPOOLING ENABLED 



<text> 



END 



LAS [ T ] 
NEX[T] 



The default <text> message is "by operator." The 
message appears when you try to queue a file. 

Terminates QUEMAN in an orderly manner and disables 
queuing and spooling. If any spooling programs are on 
line to QUEMAN, END sends to OPSER the informational 
message "Spoolers still online - will clear table" and 
clears the online spooler table. END then sends a 
command to OPSER that takes the QUEMAN entry out of 
OPSER tables. QUEMAN closes its work files and removes 
its job from the system. 

Sends to OPSER the most recent message generated by 
QUEMAN . 

guenam=regnam 

Places the pending user request identified by regnam 
at the head of the queue specified by guenam. A 
request name can contain a job name, PPN, and sequence 
number. Request names are found in the listing 
generated by the QUE program command L dev:, where 
dev: is the appropriate queue name. For example, LP:, 
BA: , or RJ: are valid queue names. 
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Table A-6: QUEMAN Interrupt Commands (Cont.) 



+ + + 

| Command | Option and Meaning | 



OFF[ LINE] 


| Terminates 


QUEMAN as the 


END command does 


but does not 




| generate 


a 


notification 


message . 




STA[TUS] 


| Prints a 


brief report of 


spooling jobs on 


-line to 




| QUEMAN . 











When a command is received from the operator through OPSER, QUEMAN 
performs the action requested and either generates a message or an 
information line. OPSER formats the message or information line and 
displays it on the OSC. An example of this interaction between an 
operator, QUEMAN and the OPSER program is shown using the STATUS 
command. The following example assumes the operator is running the 
PLEASE program and the OSC is the keyboard on which PLEASE is running: 

VINT #6: STATUS 
COMMAND SENT TO 'OPSER' 
# 

MESSAGE 29 : 10 -MAR -85 10:48 AM JOB : 6 DET QUMRUN[ 1,2] 

1 SPOOLER(S) ON LINE - 
(25) LP1SPL LP1: FORMS=NORMAL ; 

PLEASE passes the full command line to OPSER and notifies the operator 
before it reprints the prompt. OPSER recognizes the text INT as a 
request to send unsolicited text to a spooling job. The characters 
"#6" in the command line are recognized as the number of the 
destination job to which the text must be sent. QUEMAN receives the 
text STATUS, generates a response, and sends the response back to 
OPSER. OPSER formats a message and displays it on the OSC for the 
operator . 

The STATUS command itself is the operator's way of getting information 
about jobs that are on line to QUEMAN. QUEMAN' S status printout gives 
the number of spooling jobs currently on line and supplies data on 
each job (job number within parentheses, receiver identification, 
physical unit being spooled, and program default conditions). If the 
particular spooling job is processing a request, the data in the 
printout includes the following information about the request: its 
name, the PPN under which it is queued, and its sequence number. The 
STATUS command also tells you if SPOOLING or QUEUING is disabled. 
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The NEXT command allows the operator to place a job request at the 
head of a queue. Job requests are identified by the name, account, 
and sequence number under which the request is queued. A request 
moved to the head of a queue is the next one QUEMAN sends to a 
spooling program servicing that queue. See the RSTS/E Utilities 
Reference Manual for a description of the NEXT format in the QUE < 
program discussion. 

If QUEMAN detects an error in the NEXT command, it generates an error 
message in the format: 

'NEXT' CMD: string - text 

The string is the command you entered. Table A-7 lists the possible 
error texts. 



Table A-7: NEXT Command Error Text 



Text | Meaning 



ILLEGAL PARAMETERS 


■ + 

| Only a queue name and request name, 
| separated by an equal (=) sign, are 
| allowed in the NEXT command. 


ILLEGAL SYNTAX 


| A space or an = character is missing. 


JOB IN PROCESS 


| The specified job request has already 
| been sent to the spooling program. 


MULTIPLE JOB SPECIFIED 


| The specified request name matches two or 
| more jobs in the queue. 


NO MATCH FOR JOB 


| The request name does not match any job 
| in queue. 

■ + 



QUEMAN Start-Up Procedure 

You should place commands in the system start-up command file to start 
the QUEMAN program. See "Creating and Using Command Files" in Chapter 
3 for information about creating a start-up command file. 

The following are typical commands to start QUEMAN: 

$ RUN OPSER$ : QUEMAN 
/PRIORITY: 0/RUNBURST=6 
DETACH 
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The priority is set to zero because most jobs on RSTS/E run at 
priority minus eight and QUE MAN , running at priority zero, can more 
readily process the queue file. Include the DET command to make 
QUE MAN run detached on your RSTS/E system. 

Note 

Without the PRIORITY switch, QUEMAN automatically 
sets its priority to zero. You can explicitly 
specify the switch to provide a record of what the 
program does automatically. 

Because QUEMAN examines the QUEUE. SYS file when it starts, there is no 
need explicitly to initialize the file. If the file contains bad 
data, QUEMAN resets all entries to initial states. Therefore, you 
should specify the INI command only in situations in which you want to 
explicitly initialize the queue file. 



QUEMAN Action Under Various Start-Up Conditions 

QUEMAN start-up actions depend on the way QUEMAN last terminated: 

o When QUEMAN runs after you shut down operator services in an 
orderly fashion through SHUTUP, a normal start-up procedure 
occurs. QUEMAN finds that the QUEUE. SYS file was closed 
properly. The program performs consistency checking but does 
not print any messages unless it finds problems. If the data 
is consistent, QUEMAN retains all job requests in the queue 
file and examines each request for completeness and status. 
Because QUEMAN normally starts before any spooling programs, 
there are no entries in the online spooler table. QUEMAN 
checks to see that this table is clear of entries. 

o When QUEMAN starts either after the system crashes or after 
QUEMAN itself terminates unexpectedly, it finds the queue 
file improperly closed and generates a message to that 
effect. The program performs consistency checking on the 
queue file structure and on the data in the QUEUE. SYS file 
itself, generates messages telling the results, and 
reestablishes communication with all spooling jobs. 



QUEMAN Consistency Checking 

The QUEUE. SYS file has room for 250 queued requests. QUEMAN creates 
an entry for a queued request from an entry in a free list. A request 
for a line printer or batch queue requires one entry from the free 
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list. A request queued with an AFTER date and time, however, requires 
two entries from the free list -- one for the proper queue and one for 
the AFTER queue. 

In performing consistency checking on the QUEUE. SYS file, QUE MAN 
initializes all entries if it finds one of the following conditions: 

o An entry in the free list is also in a queue or AFTER list 

o The root of the free list is outside the legal range 

o A request queued with an AFTER date and time that has not 
expired does not have an entry in the AFTER queue 

For other inconsistencies, QUEMAN either may remove a single entry or 
perform some related action. If an entry in the AFTER queue has no 
corresponding entry in a spooling queue, QUEMAN removes the AFTER 
entry. If an entry in either an AFTER or spooling queue is not 
completely set up, the program removes the entry. (QUEMAN may have 
terminated while it was processing the request.) To signal this event, 
QUEMAN generates a message in the format: 

%LPn: 'reqnam' [ p,pn] ; QUEUED JOB INCOMPLETE - REMOVED FROM QUEUE 

If an entry to be killed still remains, QUEMAN removes it and 
generates a message in the format: 

%LPn: 'reqnam' [ P/pn] ; QUEUED JOB IN 'KILL' STATUS - REMOVED FROM 
QUEUE 

If QUEMAN finds that an entry has been processed (sent to a spooling 
program) but not yet completed, it places the request in a hold status 
and generates text in the format: 

%LPn: 'reqnam' [p,pn];JOB PREVIOUSLY SENT TO SPOOLER; 
WILL BE PUT INTO HOLD STATUS 

The requester can remove the job request from hold status. 

QUEMAN checks the online spooler table in the QUEUE. WRK file for 
consistency. If the program finds the table empty, it generates the 
informational message: 

# SPOOLERS ON LINE = 0; WILL CLEAR TABLE 

If the program finds that the count of online spooling jobs is larger 
than the limit (16), it clears the table and generates the 
informational message: 

ONLINE SPOOLER TABLE CORRUPT - WILL CLEAR TABLE 
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If QUE MAN clears the online spooler table but spooling jobs are still 
running, the operator must terminate those jobs through OPSER and 
restart each spooling program. This action allows QUE MAN to put each 
spooling job on line again properly. 

For each spooling program found in the online job table, QUE MAN 
removes the entry and generates the informational message: 

'rcvrid' (nn) FOUND ON LINE TAKEN OFF LINE 

QUEMAN sends the job a message requesting that it declare itself on 
line to QUEMAN again. The spooling job does not respond to the 
message while it is processing a queued request. The answering 
message indicating that the job is again on line to QUEMAN does not 
appear until the job completes the current request. When QUEMAN 
receives the online declaration from a spooling job, it generates the 
informational message: 

'rcvrid' (nn) PUT ONLINE 



Line Printer Spooling Program: SPOOL 

The line printer spooling program SPOOL runs without operator 
intervention and executes queued requests to transfer disk files to a 
line printer or terminal. The program consists of three modules: 

o SPOOL -- Establishes initial conditions on start-up and 
checks initial conditions upon restart 

o SPLIDL -- Executes when no job is being printed 

o SPLRUN -- Prints any spooled file 

Each module is stored in the OPSER package account OPSER$:, has a 
protection code of <232>, and requires SWCFG privilege to run. For 
simplicity, this appendix refers only to one program, SPOOL, which 
functionally includes the three modules. 

The SPOOL program runs only if the user has SWCFG privilege and the 
OPSER and QUEMAN programs are running. To start SPOOL, type the 
following command while logged in to the system under an account with 
SWCFG privilege: 

$ RUN OPSER$: SPOOL 

SPOOL V9 RSTS V9 TIMESHARING 

# 

Typically, this is done in the system start-up file. 
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At this point, the SPOOL program performs a number of preliminary 
checks before it prints the number sign (#) prompt. The remaining 
portion of this section describes these initial program checks. Once 
you are familiar with this procedure, you can then learn the options 
SPOOL accepts in response at its program prompt. A description of 
these SPOOL program checks follows. 

If you do not have SWCFG privilege, the system displays an error 
message to indicate that you do not have access to SPOOL. 

If the job has SWCFG privilege, SPOOL runs and prints its 
identification line and the # prompt. In response to the prompt, give 
a specification in the following format: 

# logical device :/start -up switch(es) 

The logical device is the name of the queue and the unit number within 
that queue from which this copy of SPOOL takes job requests to 
execute. This name ordinarily corresponds to the physical device on 
which SPOOL prints the requests; the physical device, however, may be 
changed by the PHYSICAL start-up option (see the following section 
"SPOOL Start-Up Options"). 

The logical device name must have the form LPn: or LP:, where n is a 
unit number from to 7. If the name is LPn:, the spooling job prints 
only requests queued either to that explicit unit or to the general 
spooling queue LP:. If you specify LP:, this copy of SPOOL prints 
requests in the printer queue regardless of the unit to which they 
were originally queued. The logical device specified as the queue 
name must be a line printer; the device name given must not have a 
logical assignment to some other device. 

Note 

The general spooling queue LP: is useful only on 
systems having line printers with similar 
characteristics . 

You can use any combination of the start-up switches described in the 
following section to condition the operation of the SPOOL program. A 
switch is formed by a slash (/) character and an option that may take 
an operand or other switches. 
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SPOOL Start-Up Options 

Start-up options alter default processing conditions. You use these 
options to: 

o Spool output to a different physical device 

o Change form information 

o Control job environment 

Table A-8 summarizes these options. Note that the symbol (_) is an 
underline character and not a space. 



Table A-8: SPOOL Start-Up Options 



+ + 

| Option | 
+ + 



Syntax and Meaning 



ASSIGN 



FORM 



/ASS [ IGN ] 

Reserves the physical device for this job. Without this 
option, SPOOL retries continually whenever it cannot 
gain access to the unit and is ready to print a job. 

/FOR[M]:name switch 

Defines the current form according to a name (NORMAL is 
the default name) and switches as follows: 



/ALI [GN] 

Causes SPOOL to execute a forms alignment 
procedure before processing any further queued 
requests . 

/DFL [ ENGTH ] : nnn 

Declares the device form length as nnn lines, 
where nnn is a number from 1 to 127. The length is 
that understood by the hardware of the output 
device. For example, on a line printer in the 
United States, the standard length is usually 66 
lines per page. 

/HEA[ DINGS ] :n 

Causes SPOOL to print n (from to 3 ) heading 
burst pages preceding each job request. Unless /NH 
accompanies a file specification in the QUE 
command, SPOOL also prints n burst pages preceding 
each file in a job request. The default value is 
1. 
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Table A-8: SPOOL Start-Up Options (Cont.) 



Option 



Syntax and Meaning 



FORM 
( Cont . ) 



LPFORM 



/LEN[ GTH ] : n 

Defines the length of software form as n lines per 
page, where n is a number from 1 to 127. If this 
switch is not given, SPOOL assumes 66 lines per 
page. 

/PAG [ E_E JECT ] : YES 

Indicates that the device to which this copy of 
SPOOL directs output has a hardware top of form 
capability and that the device interprets the 
formfeed character (ASCII 12) as a top-of-form 
command. This condition is the default case for 
line printer devices. 

/PAG [ E__E JECT ] : NO 

Conditions the software to translate a formfeed 
character (ASCII 12) into the proper number of 
linefeed characters because the hardware does not 
recognize the character as a top-of-form command. 
This condition is the default case for SPOOL 
output directed to terminal devices by the 
PHYSICAL option. 

/WID[ TH] :n 

Defines the width of the heading burst page as n 
characters per line. The default value is 132. 

/LPF [ ORM ] : YES 

Indicates that LPFORM characters are interpreted by the 
system software for the output device. During normal 
transfer, the program passes LPFORM characters 
unmodified to the device. This condition is the default 
for line printer devices. 

/LPF [ORM]: NO 

Indicates that the system software does not interpret 
LPFORM characters. During normal transfer, the program 
converts each LPFORM character to an appropriate number 
of line feed characters. This condition is the default 
for terminal devices. 

Note that this option affects only jobs queued with the 
/LPFORM switch. The SPOOL program does not 
automatically invoke /LPFORM processing. 
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Table A-8: SPOOL Start-Up Options (Cont.) 



Option 



Syntax and Meaning 



NAME 



PHYSICAL 



/NAM [ E ] : r c v rid 

Places the specified identification in the system 
message receiver table and in OPSER' s online job table 
This identification rather than the default 
identification is used by the operator in OPSER 
commands to access this spooling job. This 
identification must not be in use by some other job. 

/PHY[ SICAL] :dev: 

Uses this device as the physical device for this 
spooling program. Requests in the queue specified by 
the logical device are printed on this device. The 
default value is the logical device specified as the 
queue name . 



PRIORITY I /PRI[ORITY] :nnn 

Sets the job priority to nnn, where nnn is a number 
from -120 to 120. Without this option, the priority 
remains as set by LOGIN. You must have TUNE privilege 
to specify this qualifier. 

Do not use /PRIORITY after a /FORM, /NAME, or /PHYSICAL 
option, or after an LPn: designator. 

RUNBURST 1 /RUN [ BURST ]: nnn 

Sets the job run burst to nnn, where nnn is a number 
from 1 to 127. Without this option, the run burst 
remains as set by LOGIN. You must have TUNE privilege 
to specify this qualifier. 



The PHYSICAL option alters the physical device on which queued 
requests are printed. For example, requests queued for line printer 
unit 1 could be processed on another line printer unit or on a 
keyboard unit. In any event, the actual device differs from the one 
for which the requests were queued. 



The ASSIGN option reserves the actual spooled device to the job. 
Without this option, SPOOL periodically tries to gain access to the 
spooled device whenever SPOOL is ready to print and another job has 
ownership of the device. When SPOOL terminates, it deassigns the 
device. 

The NAME option allows the receiver identification to be different 
from that normally assigned by SPOOL. The identification should be 
from one- to six-alphanumeric characters and must not exist in the 
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system message receiver table. The identification must not begin with 
a number because the operator uses either this identification or a job 
number to identify a spooling job. 

The FORM option allows the default form information to be altered. 
For example, individual characteristics of the NORMAL form can be 
altered, a new form with a different name can be defined, or a forms 
alignment can be requested. A forms alignment can be requested by 
itself or in conjunction with a form alteration. When a form name 
other than NORMAL is in effect, user's queuing requests must 
explicitly specify the form name to have files printed with its 
characteristics . 

To alter the default characteristics of the NORMAL form, the operator 
can specify the appropriate auxiliary switches without the /FORM: 
switch. For example, to change the number and width of heading burst 
pages for line printer unit 0, type: 

LPO -./HEADINGS :2/WIDTH:80 

When executed, this command causes SPOOL to output two heading burst 
pages with a width of 80 characters per line print for each job 
request and each file within a request. The width used applies only 
to the burst pages, not to the data being printed. 

Specifying a form with a name other than NORMAL usually means that the 
operator must load special paper in the output device. The /ALIGN 
switch with the FORM option requests a forms alignment. The operator 
then must align the form at system start-up time. A SPOOL interrupt 
command with the /ALIGN switch can request a form alignment during 
timesharing. The section "Changing and Aligning Forms" describes the 
forms alignment procedure. 

The following message can occur when the line printer queues are 
empty, but jobs with nondefault form names exist: 

NO JOBS WAITING WITH FORMNAME 'XXXXXX' FOR SPOOLER 'LPn:' 
OTHER JOB(S) WAITING. 

***PLEASE INSPECT QUEUE AND TAKE APPROPRIATE ACTION*** 

The operator must then decide whether or not to use an interruption 
command to change the form name so the other jobs can be queued. 

The PAGE__E JECT option determines whether the SPOOL program counts 
lines to effect forms control. (The DFLENGTH option can modify the 
effect of the PAGE_E JECT option.) A value of NO with the PAGE_EJECT 
option indicates that the output device (driver) does not understand a 
formfeed character; that is, a formfeed character does not cause the 
device to position itself at top of the (paper) form. With NO in 
effect, SPOOL counts lines to effect forms control. A response of YES 
with the PAGE__E JECT option indicates that the device (hardware) 
translates the formfeed character to an appropriate number of line 
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skips to place the device at top of form. With YES in effect, SPOOL 
need not count lines and may be able to pass all forms control data 
unaltered to the device driver. (The DFLENGTH option can modify the 
effect of YES. ) 

Note 

SPOOL issues three forms - control characters: 

o Form feed character (ASCII 12) 

o Carriage return character (ASCII 13) 

o Line feed character (ASCII 10) 

No other forms - control characters are used. SPOOL 
has no provisions for changing or extending the set 
of control characters for any special device(s). 

The terms line feed and line skip are not synonymous. 
Line feed refers only to the linefeed character, 
which either SPOOL or the device driver sends to a 
device. Line skip refers to the movement of paper 
that the device itself effects. 

If NO is in effect for the PAGE__E JECT option, SPOOL ignores any value 
specified in a DFLENGTH option. The operator should specify 
/PAGE_E JECT : YES for any terminal device that has a top-of-form 
capability. 

SPOOL uses the value specified in the DFLENGTH option only if 
/PAGE__E JECT : YES is in effect. The /PAGE_E JECT : YES switch can be in 
effect either through default (on a line printer) or by explicit 
specification (for a terminal device having the form feed capability). 
The operator may specify the DFLENGTH option either at start-up time 
in a SPOOL start-up switch or during processing in a FORM interrupt 
command. For proper formatting, the DFLENGTH value must be the 
maximum number of lines that the output device skips when it receives 
a formfeed command. The number of lines is called the device form 
length. This number may differ from the length of the paper form 
being used. 

Different devices have different form lengths. Three examples can 
show how the device form lengths vary: 

o The LA180 device has a switch labeled "Length of Form," which 
has settings for 4, 8.5, and 11 inches. These settings 
correspond to 24, 51, and 66 lines per form. (The number of 
lines per form given for each setting assumes the standard 6 
lines per inch on the LA180.) If, when starting the spooling 
job, the operator sets the switch on the LA180 to 8.5 inches, 
the operator should also specify the DFLENGTH switch with a 
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value of 51. If, at some later time, the operator changes 
the setting on the LA180 to 4 inches, the operator should 
also specify a new. DFLENGTH option with a value of 24 in a 
FORM interrupt command to the spooling job. 

o Many line printers have only one form length. If the 
hardware length is 66, the value in the DFLENGTH switch 
should be 66. If the hardware form length is 51, the 
operator should specify DFLENGTH=51 when starting the 
spooling job. (The default value for DFLENGTH is 66.) 

o Some printing devices have an adjustable top-of-form. On 
these devices, the operator can adjust the device to execute 
an arbitrary number of line skips when it receives a formfeed 
character. This adjustment is made most often on 
terminal - type devices with high quality print 
characteristics. When resetting the top-of-form for this 
type of device, the operator should also specify the DFLENGTH 
and LENGTH options with the new form length information. The 
operator should also request a forms alignment for each new 
form. 

The effect of the DFLENGTH option on the SPOOL program differs for 
line printers and terminal devices: 

o For a line printer, the DFLENGTH value affects only the 
procedure SPOOL invokes when it receives an ABORT command 
while it is processing a job request. If the DFLENGTH value 
equals the current length of paper form, the program issues a 
formfeed character to position the device at the top of the 
next form. If the values are not equal, the program 
automatically invokes the forms alignment procedure to 
reestablish the top-of-form position. 

The automatic forms alignment procedure requires operator 
action to align the form and to respond to requests SPOOL 
makes. This is necessary only when the program has no way to 
determine where the top-of-form lies after an ABORT 
operation. 

o For a terminal, the DFLENGTH value controls the way SPOOL 
keeps its place on a form and the way the operator handles 
recovery procedures. If the value of the PAGE_EJECT option 
is YES, the equality of the device form length and the paper 
form length is important. If the device form length and 
paper form length values are not equal, the SPOOL program 
counts lines to maintain a record of its position on a form 
and issues an appropriate number of linefeed characters to 
simulate form feed. If these values are equal, SPOOL does 
not count lines and simply sends a formfeed character to 
position the paper at top-of-form. 
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Note 

A line printer is a device whose interface to the 
computer is through a line printer controller and 
whose designation is in the form LPn:. A terminal is 
a device whose interface to the computer is through a 
keyboard line and whose designation is in the form 
KBn:. This distinction is critical because some 
devices such as the LA180 are called printers but may 
be connected to the computer through a keyboard line. 

If the value in effect for DFLENGTH does not correctly match the 
setting of the hardware device, two undesirable conditions exist: 

o SPOOL must incur the overhead of counting lines. 

o Forms alignment may be lost during processing. 

For these reasons, DIGITAL highly recommends that the operator supply 
a new value of DFLENGTH when changing the hardware setting on the 
device . 



Line Printer Spooling 

If the physical device specified at start-up time is a line printer 
unit, SPOOL applies the default values. Table A-9 lists these default 
values . 



Table A-9: SPOOL Line Printer Default Values 



Switch 



Result 



/DFLENGTH: 66 



/FORM : NORMAL 
/HEADINGS :1 
/LENGTH: 66 
/WIDTH: 132 



The device form length is 66 unless otherwise 
specified. If you have patched the monitor to 
apply a different default form length, you must 
always specify the correct value in a DFLENGTH 
option. 

The values shown are used as the form 
definition. 
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Table A-9: SPOOL Line Printer Default Values (Cont.) 



bwitcn 


i 
1 


Result 


/LPFORM: YES 




For any line printer, SPOOL assumes that the 






device driver properly processes the special 






LPFORM characters (see the RSTS/E Programming 






Manual ) . 


/PAGE__E JECT : YES 




For any line printer, SPOOL assumes that the 






device driver properly processes top of form 




- + 


characters . 



You can also set the characteristics of a line printer with the SET 
PRINTER command (see Chapter 11). 



Keyboard Spooling 

If the physical device specified at start-up is a keyboard device, 
SPOOL applies the default values. Table A-10 lists these default 
values. 



Table A-10: SPOOL Keyboard Default Values 

+ + + 

| Switch | Result I 



/DFLENGTH : 66 


■ + 

| DFLENGTH has 


no effect unless 


PAGEJ2JECT is 




| explicitly s 


pecified as YES. 




/FORM: NORMAL 


| The values s 


hown are used as 


the form 


/HEADINGS :1 


| definition. 






/LENGTH: 66 








/WIDTH:132 








/LPFORM: NO 


| The terminal 


driver does not 


process LPFORM 




| characters. 


For any file that 


contains LPFORM 




| characters, 


SPOOL simulates the LPFORM effect by 




| issuing line 


feed characters. 




/PAGE EJECT: NO 


| Most termina 


Is do not have a 


hardware 




| top-of-form 


capability. SPOOL 


simulates 




| top-of-form 


by issuing the co 


rrect number of 




| linefeed cha 


racter s . 





A-38 



Managing the OPSER Spooling Package 



For terminals with the hardware top-of-form capability: 
o Set the value of PAGE_EJECT to YES. 

o Set the value for DFLENGTH to the actual device form length 
(see "SPOOL Start-up Options"). 

o Set the proper characteristic of the device that accepts and 
processes a form feed. Use the SET TERMINAL command to 
perform this operation (see Chapter 8). 



Start-Up Error Processing 

If you make an error when responding to the number sign (#) prompt, 
SPOOL prints a message and the unparsed command line in the format: 

7ERR0R MESSAGE 
unparsed command line 

The unparsed command line is the right-hand part of the response 
beginning at the element causing the error. Table A-ll summarizes the 
possible messages. 



Table A-ll: SPOOL Syntax Error Messages 

+ + 

| Message and Meaning | 
+ + 

?Can't parse remaining string 



Something illegal or undefined was found in the command 
line. An undefined switch or missing slash (/) character 
causes this error. 



?Duplicate switch 

Two occurrences of the same switch were found in the command 
line. 

?Illegal logical device 

The logical device specified was not in the form LP: or LPn: 
(where n is a number from to 7). 



A-39 



Managing the OPSER Spooling Package 
Table A-ll: SPOOL Syntax Error Messages (Cont.) 

+ - -: 

| Message and Meaning 

+ 

?Illegal operand 

An illegal operand was found in an option or switch. For 
example, specifying nonnumeric characters in a switch that 
requires a number (/WIDTH:n) generates this error. 

?Illegal physical device 

The device specified in the PHYSICAL option is not a line 
printer or keyboard device. 

?Missing operand 

A switch requiring an operand was specified without one. For 
example, if a receiver identification is missing from the 
NAME option, this error is generated. 
+ + 

If SPOOL encounters no syntax errors in the response, it begins 
setting initial conditions. SPOOL reports errors in this phase by 
printing a message in the format: 



ERROR IN SOME OPERATION - - RESTARTING 
error message 

The program reprints its identification line and the prompt. 

An error message ?Duplicate receiver ID means that the receiver 
identification, either the default one or the one specified in a NAME 
option, is already defined for another job. The operator should type 
the command line again and specify a unique receiver identification in 
the NAME option. 

The error message ?No room in receiver table means that a general 
small buffer is not available to let SPOOL declare itself a receiving 
job. A later retry with the same command line should succeed. 

The following message means that SPOOL attempted to send a message to 
that program and failed: 



*****OPSER HUNG***** or *****QUEMAN HUNG***** 



Either the named program does not have an entry in the system message 
receiver table or the program is not processing its messages and its 
message limit has been reached. The operator must determine the cause 
of the problem and restart the named program. 
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SPOOL Interrupt Commands 

The operator communicates with a SPOOL job by means of INTERRUPT 
commands sent through the operator services ■ program OPSER. Note that 
any responses to an INTERRUPT command are displayed on the Operator 
Services Console. 

Table A-12 summarizes these SPOOL interrupt commands. Note that the 
circumflex (~ ) character marks the location of a required space. 



Table A-12: SPOOL Interrupt Commands 



Command Syntax j Meaning 



ABO [ RT ] 




+ 

| Immediately terminates the current process 
| and removes the request from the queue. 


CON[TINUE] 


| Wakes up the spooling job to continue 
| processing after a PAUSE command. 


END 




Closes out processing after completing the 
| current request. The operator must then run 
| the spooling program again to process further 
| requests. 


FOR[ M]~ 


name/switch 


| Changes the current output form to one 

| identified by name and defined by switches. 

| These switches change current form 

| characteristics; those characteristics not 

| changed by an option remain at their current 

| definitions. See the start-up option FORM 

| description in Table A-8 for the allowable 

| options. Alignment is done only if the /ALIGN 

| switch is included. 


FOR[M] 




| Displays characteristics of the current form 
| if no name or options are in the command. 


FOR[MT 


/ALIGN 


| Requests a forms alignment procedure for the 
| current form. 


LAS [ T ] 




| Prints the most recent message generated by 
| the spooling job. 


OFF [ LINE ] 


| Immediately terminates all processing by this 
| spooling job (same as ABORT followed by END). 
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Table A-12: SPOOL Interrupt Commands (Cont.) 



Command 


Syntax 


| Meaning 


PAU[ SE] 




- + 

| Places the spooling job in a sleep state, 

| Quiiny which it icoponus iu mu s t cunuiiciiiuo aiiu 
1 resumes normal processing in response to a 
| CONTINUE command.* 


REQ[UE] 




| Stops processing the current request and 
| replaces the request in the queue so that 
1 processing laici i csunico at tiic lc iiuiiia t nig 
| point. 


RES [TART] 




| Reprints the current copy of a file from the 
| beginning, including heading burst pages. 


RES [ TART]" 


JOB 


| Reprints the current iteration of the job, 
\ inciuaing neaaing Durst pages. 


RES [TART]" 


: n 


| Reprints the current copy of the file 

| starting at page n. If n is 0, restarts from 

| the beginning of the file but omits the 

| heading burst pages. 


STAfTUS] 




| Prints a status report for the spooling job. 


* Note that processing continues if any job modification command 
such as ABORT or REQUE is sent. 



SPOOL Start-Up Examples 

This section shows four examples of the start-up procedure. They 
represent typical cases. 



Line Printer Start-Up with All Defaults 

In response to the SPOOL program prompt, the operator types: 
#LP0: 

If SPOOL finds no errors, it prints the message: 
DETACHING... 
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SPOOL detaches itself and leaves the terminal logged off the system. 

The following are the characteristics of this copy of SPOOL: 

o The program prints only job requests that were queued to line 
printer unit with a form name of NORMAL or queued to the 
general line printer queue with a form name of NORMAL. 

o The program prints on line printer unit 0. 

o The program prints one heading burst page before each job 
and, unless a file is queued with /NH, prints one heading 
burst page before each file. The width of the burst page is 
132 columns, and the form length is 66 lines. 

o The program assumes the device driver handles LPFORM 
characters . 

o The program assumes the device handles top-of-form. 

o The program assumes the device form length is 66 lines. 

o The run burst and priority of SPOOL are those in effect when 
the job starts. 

o When the program receives a job from QUEMAN, it attempts to 
assign the printer. If the assignment fails, the program 
retries periodically until it succeeds. When it finishes 
processing a job request, the program deassigns the device. 

The operator may later change all form characteristics (name, length, 
width, device form length, and headings count) through appropriate 
interrupt commands. 



Line Printer Start-Up with Narrow Width 

In response to the prompt, the operator types the command line: 

#LPl :/FORM : NARROW/WIDTH : 80/RUNBURST : 12/ASSIGN 

The following are characteristics of this copy of SPOOL: 

o The program prints only jobs queued with a form name of 
NARROW and queued to either unit 1 or the general line 
printer queue. 

o The program prints on the line printer 1 device. 

o The program prints one heading page of width 80 columns; form 
length is 66. 
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o The program assumes the device handles top-of-form. 

o The program assumes the device driver handles LPFORM 
characters . 

o The program assumes the device form length is 66. 

o The priority of the job remains unchanged. The program sets 
the run burst to 12. 

o The program does not begin spooling until it can assign line 
printer unit 1 and does not deassign the device until it 
terminates. 

In this example, assume that line printer unit 1 is a relatively slow 
device and that the SPOOL program can generate output data for this 
unit faster than the device can print. Optimal use of the device 
results if the unit keeps running at full speed for the entire job 
request it is printing. 

To effect optimal use, it is sometimes necessary to raise either the 
priority or run burst of the SPOOL program. The priority of a job 
generally affects how often it runs, whereas the run burst affects the 
length of time the job runs once it starts running. Because the SPOOL 
program is usually I/O bound and waiting for the device to complete 
printing, there is little reason for it to run more often. Changing 
the priority is usually unnecessary and ineffective. Changing the run 
burst, however, may improve processing. 

When SPOOL starts executing, it remains in the run state until one of 
the following events occurs: 

o The job's run burst expires. That is, the job actually 
executes for its full run burst. 

o The job requests some type of I/O and the system cannot 
immediately satisfy the request. 

For the spooling program, the second event is much more likely because 
the system buffers only a fixed amount of data before it refuses to 
satisfy further requests for output. When the refusal occurs, the 
system activates another job and the spooler must wait until the 
system sends at least some of the already buffered data to the output 
device. (This wait condition shows as an LP or TT STATE on a SYSTAT 
li sting . ) 

As long as the buffers for the device are never completely emptied, 
the system keeps the device running at or near full speed. To a 
certain point, raising the spooling job's run burst makes it more 
likely that the job will continue running until it completely fills 
the buffers for its output device. After a certain point, raising the 
run burst has little benefit because the job can run only until the 
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buffers are full. Conversely, decreasing the run burst causes the 
system to deactivate the program before the buffers are full. It is 
more likely that the printer can empty the buffers before the system 
reactivates the job. 

If a spooling job spends a significant time in the RN state while it 
is actually printing, the run burst is too low. DIGITAL recommends 
that you raise the run burst to a value at which the job spends most 
of its time in an output wait state. 



Keyboard Start-Up on an LA36 

For this example, assume that keyboard unit 5 is an LA36 terminal. At 
the prompt, the operator types a command line as follows: 



# LP2 :/PHYSICAL : KB 5 : /HEADINGS : 0/ASSIGN 

The following are the characteristics of this copy of SPOOL: 

o The program prints only jobs queued with a form name of 

NORMAL and queued to the unit 2 or the general line printer 
queue . 

o The program prints on keyboard unit 5. 

o The program prints no heading burst pages. The form length 
is 66 . 

o The program assumes that keyboard unit 5 does not handle 

top-of-form; therefore, it counts lines as it prints them to 
simulate top-of-form. 

o The program assumes the device driver does not handle LPFORM 
characters; therefore, it simulates LPFORM with line feeds. 

o The run burst and priority remain unchanged. 

o The program assigns keyboard unit 5 at start-up and keeps it 
assigned until it terminates. 

Because the LA36 is a slow device, processing is not slowed any 
further with burst pages. The /HEADINGS : switch suppresses printing 
of burst pages. 

To retain any forms alignment on the LA36, the device is permanently 
assigned to the spooling job. This assignment prevents any other job 
from using the device and leaving the carriage at a position other 
than the top of form position. When the spooler starts processing a 
request, it must assume the device is at its top of form position 
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because the program has no way to force the device to advance to some 
known position. If the form is not aligned properly when SPOOL starts 
the output, the entire output is misaligned. 



Keyboard Start-Up on an LA180 

For this example, keyboard unit 2 is a serial LA180 DECprinter. This 
terminal has a hardware top-of-form capability. In addition, the form 
length selector switch on the terminal is set to 8.5 inches (51 lines 
per form) and the paper form is also 51 lines per page. 

In response to the prompt, the operator types a command line as 
follows : 

#LP3 -./PHYSICAL: KB2 :/PAGE_EJECT: YES/DFLENGTH: 51/LENGTH: 51- 
MORE> /WIDTH : 4 0/FORM : SPECIAL 

The following are the characteristics of the SPOOL copy: 

o The program prints only requests queued with a form name of 
SPECIAL and queued to either the unit 3 or the general line 
printer queue. 

o The program prints on keyboard unit 2. 

o The program prints one heading page that is 40 columns wide 
and 51 lines in length. 

o The program assumes the device handles top of form. 

o The program assumes that the device driver does not handle 
LPFORM characters. The program therefore simulates LPFORM 
with line feeds. 

o The run burst and priority remain unchanged. 

o The program assigns the keyboard before it prints each 
request and deassigns it after printing the request. 

Because : 

o The LA180 is a much faster device than the LA36, SPOOL can 
print a small number of burst pages to simplify 
distinguishing jobs and files. The narrowest width for the 
burst page is 40 columns. 
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o The paper form length and the device form length are equal, 
SPOOL can position the device to top-of-form by issuing a 
formfeed character. 

o The program can position to top-of-form, it does not need to 
keep the unit assigned. 

The ASSIGN option, therefore, does not appear in the example. If the 
paper form length did not equal the hardware setting, however, SPOOL 
should keep the device assigned to preserve the top-of-form position. 



Recovery from Line Printer Errors 

The interaction between the spooling job and the OPSER program 
controls error handling in the SPOOL program. For example, if the 
paper runs out or jams, SPOOL receives the error message: 

PDevice hung or write locked 

SPOOL discontinues processing and sends OPSER a message. OPSER 
generates a message for the operator: 

MESSAGE 3 : 28 -MAR- 85 04:33 PM JOB: 21 DET SPLRUN[ 1 , 100 ] 

LPO : HUNG -- JOB: [ 22 , 4 ] USERl 
(PUT DEVICE ONLINE TO CONTINUE) 

The message tells the operator that the spooling job for line printer 
unit has a problem and that the device needs to be made ready again 
before processing can continue. 

For a SPOOL program servicing a line printer, there are certain errors 
from which you can easily recover. The device handler for the line 
printer tests the ready status of an offline unit every 10 seconds. 
If the operator corrects the error (for example, fixes a paper jam) 
and puts the line printer on line again, the software detects the 
ready status and continues printing buffered characters. The SPOOL 
program finds that the error condition is cleared and continues 
processing . 

If a special form is being processed and SPOOL receives an error, 
SPOOL may request the operator to realign the forms before it 
continues processing on its own. 

If the operator cannot correct the error or wants to perform some 
other operation, the spooled device may be left off line. This 
prevents the software from reprinting before the program processes an 
operator request. The operator uses the INTERRUPT command with the 
proper text to access the spooling job. 
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SPOOL allows the operator several ways to control the restart of a 
queued request. The RESTART command can restart: 

o The current copy of a queued request (RESTART JOB) 

o The current copy of a file in a queued request (RESTART) 

o The current copy of a file at a specific page ( RESTART : nnn ) 

The REQUE command can reenter the current job in the queue for later 
processing. On receiving a RESTART command, the program waits for any 
currently buffered data to be printed before actually restarting. 

The REQUE command causes SPOOL to remember the point at which 
processing was interrupted. After resuming the requeued request, 
SPOOL scans for the page on which processing terminated and continues 
printing at the start of that page. An error may occur if a user 
modifies the requeued request before SPOOL can resume the printing. 

If the operator responds to an error condition with an ABORT command, 
which terminates the job, SPOOL clears the output buffers on the line 
printer unit. If the device is a terminal, SPOOL prints any buffered 
data. The program then issues a message to show that it is 
terminating . 

Before terminating a queued request, the SPOOL program make sure that 
all buffers have been emptied successfully. 



Line Printer Output 

SPOOL generates job header and file header burst pages to identify 
print requests and files within a print request. Both types of header 
page contain identification and general accounting information as 
follows : 

o The identification consists of large, easily readable block 
letters created from the character generation file CHARS. QUE. 
The job identification contains the account number of the 
user requesting the job and the name of the job. If no job 
name appeared in the QUE command, SPOOL prints the name of 
the first file in the request as the job name. The file 
identification shows the file name and type. 
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o General accounting information for the job header is on the 
burst page and is offset from the identification by two rows 
of special characters. The accounting information contains 
five lines of data: 

The first line gives the job name, current date, current 
time of day, and the requester's account number. 

The second line gives the date and time of day of the 
request and the device for which the request was queued. 

The third line gives the system name. 

The fourth line gives the QUE options used to process the 
request . 

The fifth line gives the job copy number. 

The accounting information for the file header burst page 
appears below the identification and is framed (above and 
below) by two rows of special characters. The first line of 
information gives the job name used when SPOOL printed the 
file and shows the current date, time of day, and account as 
the job header burst page does. The second line gives the 
copy number, the QUE options used on the file, and the 
complete specification of the file. The third line gives the 
record type and carriage control format used to print the 
file. 

If SPOOL does not print the file because of an error, file header 
identification and accounting information is replaced by an error 
message framed (above and below) by five rows of special characters. 
The error message is standard RSTS/E error text. 



Error Messages During User Output 

SPOOL reports errors it receives during printing in the line printer 
output. SPOOL differentiates the error message from requested output 
by framing the text (above and below) with five rows of special 
characters . 

Table A-13 shows the possible SPOOL error messages and related 
meanings . 
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Table A-13: SPOOL User Requested Output Error Messages 

+ 

| Message and Meaning 

+ 

?Can't find file or account 

The related file was deleted between the time it was queued 
and the time SPOOL tried to print it. 

?File restart requested on page n 

The operator requested a restart at the indicated page or 
placed the job request back in the queue with the REQUE 
command. If the operator restarted the job request, SPOOL 
scans the file to find the correct page and continues 
printing on a new page following the message. If the 
operator requeued the job, this message appears when SPOOL 
restarts the job. 

?Job aborted 

Either the operator terminated the job request with an ABORT 
command or the K command of the QUE program was issued while 
the job was being printed. 

?Job aborted because of file error(s) 

Errors in some file in the job prevented SPOOL from printing 
the remainder of this job. 

?Job requed at page n 

The operator placed this job request back in the queue with 
the REQUE command. SPOOL later continues the job request 
with a new header burst page and the text FILE RESTART 
REQUESTED ON PAGE n, where n is the same page number shown 
in the REQUE message. 

?<error text> 

SPOOL encountered the RSTS/E error shown, aborted processing 
the request, and cleared the request from the queue. 
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Changing and Aligning Forms 

The FORM command can: 

o Inform the spooler of a change in form on its device 

o Request an alignment operation on the device 

o Display information about the current form 

Switches with the command specify the new form definition and request 
alignment. The command may request alignment when a new form is 
specified . 



To request a form change, the operator sends the FORM command with the 
form name and the switches to define the form to the related spooling 
job. If an alignment is wanted for the current form, the operator can 
include the /ALIGN switch with the FORM command. The SPOOL program 
does not recognize the form change request until it becomes idle. If 
it is processing a queued request, it completes the processing before 
it performs the forms change. (To make the change immediately, 
request that SPOOL requeue the current request. The program requeues 
the request and becomes idle.) 

To perform only an alignment, specify the FORM command without any 
form name and with only the /ALIGN switch. Again, the command takes 
effect only when SPOOL becomes idle. The program follow these steps: 



1. Prints characters to delineate left and right margins, and 
prints the text TOP OF FORM centered on the same line. 

2. Generates characters to position the paper on the last line 
of the form. 



3. Prints characters to delineate the left and right margins, 
and prints the text END OF FORM centered on the same line. 



4. Positions the paper at top of the next form. 



SPOOL generates an action request and awaits a response. The operator 
may inspect the alignment and type one of two responses to the action 
request. If the alignment is not correct, the operator can adjust the 
hardware and send the response RETRY back to the spooler. In response 
to RETRY, the spooler performs steps 1 through 4 again and generates 
another action request. When the alignment is accurate, the operator 
types GO as a response to the action request. The spooler returns to 
normal processing. 

Whenever SPOOL processes any FORM command, it sends a message to the 
operator indicating that the new form characteristics in effect. In 
any FORM command, only those options specified in the command change 
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the form characteristics. Thus, if the operator sends a FORM command 
alone, without a form name or any options, the spooler displays the 
characteristics of the current form on the Operator Services Console. 



Batch Processor Program: BATCH 

The BATCH system program runs without user intervention and executes 
files of standardized commands queued for either a specific or the 
general Batch Processor. The program consists of four modules: 

o BATCH sets initial conditions for batch processing. 

o BATIDL checks status when no requests are being handled. 

o BATDEC decodes and performs error checking on command files. 

o BATRUN executes the decoded batch commands. 

For simplicity, this appendix refers only to one program, BATCH, which 
functionally includes the four modules. Each module is stored in the 
OPSER package account OPSER$ : , has a protection code of <232>, and 
requires SWCFG privilege to run. 

To run BATCH, type the following command while logged in to the system 
under an account with SWCFG privilege: 

RUN OPSER$: BATCH 

BATCH V9 RSTS V9 TIMESHARING 

# 

Typically, this start-up of BATCH is done in the system start-up file. 

If you do not have the SWCFG privilege, the system displays an error 
message indicating that you do not have access to BATCH. 

If you have the SWCFG privilege, BATCH runs and prints its 
identification line and the number sign (#) prompt. In response to 
the # prompt, enter a specification in the following format: 

logical device :/start -up switch(es) 

The logical device is the name of the queue and the unit number within 
that queue from which this copy of BATCH takes job requests. This 
name does not specify the pseudo keyboard on which BATCH executes 
requests. The PHYSICAL start-up option can specify the pseudo 
keyboard unit on which BATCH executes. The logical name must have the 
form BA: or BAn: where n is a unit number from to 7 . If BAn: is 
specified, the Batch Processor executes requests queued to either that 
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explicit unit or the general batch queue BA: . If BA: is specified, 
the program executes job requests in the batch queue regardless of the 
unit to which they are queued. 

Note 

The general batch spooling queue, BA: , is useful only 
on systems with Batch Processors running with the 
same default conditions. 

The logical device specified as the queue name must be a Batch 
Processor; the device name given must not have a logical assignment to 
some other device. 

If only a queue name is given in response to the prompt and BATCH 
finds no errors, the program establishes default processing 
conditions, prints the DETACHING message, and detaches itself from the 
terminal . 

BATCH forms the default receiver identification from the queue name. 
BATCH also establishes other default conditions: 

o BATCH tolerates no errors and terminates any queued request 
encountering a fatal or warning error. 

o User log files are queued to the system default line printer 
with deletion specified. 

o The run burst remains unchanged. 

o The priority remains unchanged. 

At start-up, BATCH performs the same error checking and processing 
SPOOL performs. See the section "Start-up Error Processing" for the 
description of SPOOL start-up error processing. 



BATCH Start-Up Options 

Include options with the BATCH processor designator to control its 
operation. 

Table A-14 summarizes these options, which are in the form of 
switches . 
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Table A-14: BATCH Start-Up Options 



+ 



Option 



Syntax and Meaning 



ASSIGN 



ERROR 



DELETE 



NAME 



NODELETE 



NOQUEUE 



/ASS [ IGN ] 

Reserves a pseudo keyboard device to this job. 
/ERR [ OR] : severity 

Sets the error severity default for this processor so 
that errors of that severity are tolerated and queued 
requests having that or lesser severity end 
successfully . 

/ERR [OR] : FAT [ AL ] 
Tolerates all errors. 

/ERR [OR] :WAR[NING] 

Tolerates only warning errors. 

/ERR [ ] R : NON [ E ] 

Tolerates no errors (fatal and warning errors terminate 
queued requests). This is the default severity. 

/DEL [ ETE ] 

Deletes user log files after printing. This is the 
default condition unless the NODELETE option is 
specified. 

/NAM [ E ] : rcvrid 

Places, in the system message receiver table, the 
specified receiver identification for this job instead 
of the default identification. The default for a Batch 
Processor is BAnSPL for specific processors and BASPL 
for the general processor. 

/NODEL [ ETE ] 

Does not delete user log files after printing. Without 
this option, all log files are deleted. Requester may 
override this option with the /NOQUE switch in the $JOB 
command . 

/NOQUE [UE] 

Does not queue user log files for printing. Without 
this option, all log files are queued without a queue 
name and with deletion unless changed by the /QUEUE and 
/DELETE switches. Requesters cannot override this 
option . 
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Table A-14: BATCH Start-Up Options (Cont.) 



+ + 

| Option | 
+ + 



Syntax and Meaning 



PHYSICAL 



PRIORITY 



QUEUE 



RUNBURST 



/PHY[ SICAL] :dev: 

Uses the pseudo keyboard (for example, PKl : ) 
device on which this processor executes user 
j obs . 



as the 
batch 



/PRI [ORITY] :nnn 

Sets the job priority of BATCH to nnn, where nnn is a 
number from -120 to 120. Without this option, the 
priority remains unchanged. You need TUNE privilege to 
specify this qualifier. 

Do not use /PRIORITY after a /NAME, or /PHYSICAL 
switch, or after a BAn: designator. 

/QUE[UE] : [quenam] 

Queues all user log files to the specified spooling 
queue (LPO: through LP7 : ) rather than to the general 
print queue. If no queue name is specified, all jobs 
are queued to the general print queue. Files are 
deleted after printing. Requesters may override queuing 
with the /NOQUE switch in the $JOB command. Deletion of 
the files by the SPOOL program may be overridden by 
including /NODELETE as a start-up switch. 

/RUN [BURST] :nnn 

Sets the job run burst of BATCH to nnn, where nnn is a 
number from 1 to 127. Without this option, the run 
burst remains unchanged. You need TUNE privilege to 
specify this qualifier. 



BATCH Interrupt Commands 

The operator uses interrupt commands sent through the operator 
services program OPSER to communicate with a Batch Processor. Note 
that any responses to an interrupt command are displayed on the 
Operator Services Console. 

Table A- 15 summarizes these BATCH interrupt commands. 
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Table A-15: BATCH Interrupt Commands 

+ + + 

| Command Syntax | Meaning | 



ABO[RT] 


| Immediately terminates the current process and 
| removes the request from the queue. 


CON [ TINUE ] 


| Wakes up the Batch Processor to continue normal 
| processing after either a PAUSE command or after 
| a user request for operator action (for example, 
| in the $MES SAGE/WAIT command). 


END 


| Terminates processing after completing the 

| current request. The operator must then run the 

| Batch Processor again to process further 

| requests . 


LAS [ T ] 


j Prints the most recent message generated by this 
| Batch Processor. 


NOT[ICE] text 


| Inserts the specified text in the user log file 
| and precedes it with the heading: NOTICE FROM 
| OPERATOR. 


OFF[ LINE] 


| Immediately terminates all processing by this 
j Batch Processor (same as END followed by ABORT). 


PAU[SE] 


| Places the Batch Processor in a sleep state, 
| during which it responds to most commands and 
| resumes normal processing in response to a 
| CONTINUE command. 


STA[TUS] 


| Prints a status report for this Batch Processor. 



BATCH Start-Up Procedure 

BATCH is most conveniently started by commands in the system start-up 
command file. See the section "Creating and Using Command Files" in 
Chapter 3. 



Operator Action Requests from BATCH 

The BATCH program, in processing certain commands in a user command 
file, generates requests for operator action. These requests come 
through OPSER as action requests that require some operator action and 
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a typed answer before the Batch Processor continues processing. These 
action requests result from commands requiring the operator either to 
mount and dismount volumes or to respond to a special message with 
which a stall is involved. The operator answers an action request 
with the ANSWER command through OPSER. 

On a mount request, BATCH asks the operator to mount a device by an 
action request with text in the following format: 

MOUNT xx:' logical id'/' vid ' /WRITE/NOWRITE/DEN : nn/PAR : nn 
DEVICE? 

If a specific volume is involved, its identification appears as text 
replacing 'vid.' This text is the visual identification used to 
distinguish the volume. 

Table A-16 lists the specific device type given by xx : . 



Table A-16: BATCH Device Type Designators 



| Designator | Meaning 



CD 


| CDll punched card reader 




CR 


| CRll high speed punched card reader or 
| marked-sense card reader 


the CM11 


DB 


| RP04, RP05 or RP06 disk pack drive 




DK 


| RK05 or RK05F disk cartridge drive 




DM 


| RK06/RK07 disk cartridge drive 




DL 


| RL01/RL02 disk pack drive 




DP 


| RP02 or RP03 disk pack drive 




DR 


| RM02/RM03/RM05/RM80 disk pack drive 




DT 


| TU56 DECtape drive 




DU 


j All MSCP disks: RA60, RA80, RA81, RD51, 
| RX50 


RD52, RC25, 


DX 


| RX01/RX02 floppy disk drive 




LP 


j Any line printer 




MM 


| TU16, TE16, TU45, or TU77 magnetic tape 


drive 


MS 


| TS11, TSV05, TK25, or TU80 magnetic tape drive 


MT 


| Any magnetic tape drive 




PP 


| High speed paper tape punch 




TT 


| Any keyboard line 





If the text of the action request indicates a specific volume, the 
operator should mount the medium on a free unit of the device type 
specified by xx:. If a volume is not involved, the operator should 
make sure a unit of the type specified by xx: is ready and on line. 
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When the unit is ready, the operator must type the device 

specification (device type and unit number followed by colon) as text 

in the ANSWER command for that action request number. BATCH assigns 

that unit and continues processing the user's queued request. 

When BATCH is done with the device, it generates an action request to 
dismount the volume or device. If the request involves a volume, the 
operator must remove the volume from the device specified and place 
the unit off line. To continue the BATCH processing, the operator 
types the CONTINUE command as text in the ANSWER command to OPSER for 
that action request number. This response tells BATCH to deassign the 
unit and to continue processing. 



Operator Communication Program: PLEASE 

The PLEASE program communicates directly with the operator services 
program OPSER and, when OPSER is not running, sends text to the system 
console terminal ( KBO : ) . The program PLEASE is stored in the OPSER 
package account OPSER$: with protection code of <232>. 

Any user can run PLEASE, but only users with SWCFG privilege or users 
defined as valid operators in the operator table can issue OPSER 
commands . 

You, as the system manager or assigned operator, can run PLEASE to 
send commands to OPSER. Users who do not have SWCFG privilege and are 
not valid operators may run PLEASE to send text to the Operator 
Services Console. 

Note 

If you want to restrict PLEASE to only be run by 
users with WREAD privilege, change its protection 
code to <124>. 



Running and Terminating PLEASE 

To run PLEASE, type the following command: 

RUN OPSER$ : PLEASE 

PLEASE V9 RSTS V9 TIMESHARING 

# 



PLEASE prints its identification line and the number sign (#) 
character as a prompt to indicate it is ready to accept text. 
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PLEASE accepts one line of text terminated with the RETURN key. A 
line of text exceeding the maximum length (255 characters) causes the 
program to print the error message ?Line too long and reprint the 
prompt. If the first character of text is not a slash (/) character, 
PLEASE tries to send the text as a message to OPSER. If the first 
character of text is a slash, PLEASE tries to send the text as a 
command to OPSER. To show the operator that it is sending the message 
or command, PLEASE prints one of the following messages: 

Message sent to 'OPSER' 
Command sent to 'OPSER' 

The program prints the # prompt again, after which the operator can 
type another line of text. Entering CTRL/Z in response to the prompt 
terminates the program. 

When OPSER is not active, PLEASE broadcasts messages on the system 
console terminal; however, it does not send commands. In these 
situations, the program notifies the user with one of two messages: 

%OPSER not active - message broadcast to KBO: 
%OPSER not active - command not sent 

The message printed on keyboard unit is preceded by the text: 

%MSG for 'OPSER' but it is not active: 



OPSER Commands through PLEASE 

Any user with SWCFG privilege or defined as a valid operator can 
communicate with OPSER and with jobs on line to OPSER by typing a 
command through PLEASE. The user denotes an OPSER command by typing 
the slash (/) character as the first character in the line of text. 

Table A- 17 summarizes these PLEASE commands to OPSER. Note that the 
circumflex (* ) character marks the location of a required space. 
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Table A-17: PLEASE Commands to OPSER 

+ + — + 



Command Syntax | Meaning 



/ANS" msgnumber : text 


• + 

| Responds to an action request. 


/CHA" KBn : 


| Changes operator services console to 
| keyboard unit n. 


/DEL" msgnumber 


| Deletes outstanding action request. 


/DEL #nn:n 


| Deletes n oldest action requests for job 
j number #nn. 


/DET 


| Detaches OPSER from the OSC. 


/EXI 


| Terminates OPSER. 


/INT" rcvridrtext 


| Sends unsolicited text to online job. 


/LIS" JO 


| Prints online job table. 


/LIS" OP 


| Prints valid operator table. 


/LOG" f i le ; msglevel 


| Creates log file and sets message level. 


/LOG" ;msglevel 


| Changes message level of current log file. 


/LOG 


j Closes current log file and stops recording. 


/MES" msglevel 


| Sets message level for OSC. 


/OPE" KBn : \ nnn . nnn 1 


1 Adds kevboard and account combination to 
| valid operator table. 


/OPE" - KBn : [ nnn , nnn ] 


| Removes keyboard and account combination 
j from valid operator table. 


/RET" msgnumber 


| Prints associated message. 


/RET" m:n 


| Prints oldest m action requests for job 
| number #n. 
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When OPSER receives a command from PLEASE, it makes sure that the user 
has SWCFG privilege or that the user's keyboard and account numbers 
are present in the valid operator table. If not, OPSER broadcasts the 
error message ?Invalid oper on the terminal from which the command was 
made . 

Commands sent by a valid operator can be executed by OPSER itself or 
by a program on line to OPSER. If OPSER itself executes the command, 
any response from the command is broadcast on the originating 
terminal. For example, because OPSER itself processes the LIST JOBS 
command, the online job list generated appears on the originating 
terminal . 

An INTERRUPT command, however, passes text to another program. Any 
response from the other program is displayed on the OSC and not on the 
originating terminal. To see a message or response from an INTERRUPT 
command, the operator should change the OSC to the current keyboard 
(the line on which PLEASE is running) before transmitting the command. 
Action requests and messages (responses to commands or text sent to 
OPSER) are displayed only if the current message level allows. 



PLEASE as a CCL Command 

If you install PLEASE as a CCL command, the operator can type PLEASE 
followed by a text line to send commands to OPSER. PLE is the 
standard abbreviation for the CCL command. 



Terminating Operator Services and Spooling 

Usually you terminate OPSER and programs on line to OPSER by running 
the SHUTUP program. SHUTUP, however, terminates time-sharing 
operations. If it is necessary to terminate operator services and 
spooling without shutting the system down, the operator can type a 
sequence of commands to stop spooling operations in an orderly 
fashion. To understand the sequence, you must know about OPSER 
shutdown levels. 



OPSER Shutdown Levels 

When OPSER receives a command from SHUTUP to perform an orderly 
shutdown in logical end mode, OPSER sends an END command to each 
online job in a fixed, logical sequence. OPSER selects by shutdown 
level the order in which jobs are ended. Online jobs at the lowest 
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level terminate first. When all jobs at one level have terminated and 
have been removed from OPSER ' S internal tables, OPSER begins sending 
END commands to jobs at the next highest level. When all online jobs 
have properly terminated, OPSER kills itself and SHUTUP proceeds with 
the system shutdown. 



OPSER Manual Shutdown Procedure 

You may need to shut down the SPOOL program without shutting down the 
entire system. The two possible procedures are as follows: 

o The operator can issue the END command to the spooler at any 
time. This command causes the spooler to shut itself down 
the next time it is ready to get a new job. Thus, if the 
spooler is printing a job, it completes the job's output 
before shutting down. If SPOOL is waiting for a job, it 
shuts down immediately. The operator can use the ABORT 
command to terminate the job if the operator wants the job 
currently printing to end. 

For example, to manually shut down the LPOSPL spooler in 
logical end mode, use the command: 

PLE/INT LPOSPL: END 

At the completion of the current job, the spooler kills 
itself. This shutdown procedure merely mimics what OPSER 
does on command from SHUTUP. The operator sends the END 
command, in turn, to jobs at each shutdown level. The output 
of the LIST JOBS command gives the shutdown levels for each 
online job. When OPSER displays END messages for all jobs at 
one shutdown level, the operator can send the END command to 
all jobs at the next highest shutdown level. After the 
online job table is clear and OPSER has generated END 
messages for all jobs, the operator can send the EXIT command 
to OPSER. 

o A second way of shutting down the spooler is with an OFFLINE 
command. The OFFLINE command immediately stops any job that 
is printing and prints an ABORT message on the listing to 
indicate the action taken. The OFFLINE command also causes 
SPOOL to shut down after the current job finishes. 

For example, to manually shut down the BAOSPL job 
immediately, use the command: 

PLE/INT BAOSPL -.OFFLINE 

BAOSPL aborts the current job, clears it from QUEUE. SYS, and 
kills itself. 
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If the operator wants to terminate a printing job for shutdown or any 
other reason, the line printer must be on line. Under no 
circumstances does the spooler consider a job completed until all the 
data that the spooler tries to print (including termination messages) 
is actually printed. If the operator aborts the job with the ABORT 
command, the spooler deletes (at the first opportunity) whatever data 
is already buffered; the line printer must be on line to allow this. 

If the operator wants no further output, use the REMOVE/JOB command to 
remove the spooler job. In this case, no clean-up can be performed. 
This process may be necessary when certain hardware fails (for 
example, if the line printer interface does not raise the READY flag). 
It should only be used in a crisis. The job that was being printed 
should be killed from the queue file by a QUE/K command from the 
operator. 



RESTOR as an OPSER Controlled Program 

The RESTOR program runs as a job on line to OPSER only after it has 
finally detached from its terminal. When RESTOR is running detached, 
the operator can send commands to it through OPSER. If, after having 
been detached, RESTOR is later attached to a terminal again, the 
operator can communicate with RESTOR either at its terminal or through 
the OPSER program. 

Table A-18 summarizes the commands that RESTOR recognizes. Note that 
the circumflex (" ) character marks the location of a required space. 



Table A-18: RESTOR Commands through OPSER 



+ + 

| Command Syntax | 
+ + 



Meaning 



ABO [ RT ] 



CON[ TINUE] 



Terminates the RESTOR run immediately and removes 
RESTOR from OPSER internal tables. 

Wakes up the RESTOR program to continue 
processing after a PAUSE command or continues 
processing after an operator has performed some 
requested action. 



A-63 



Managing the OPSER Spooling Package 



Table A-18: RESTOR Commands through OPSER (Cont.) 



+ + 

| Command Syntax | 
+ + 



Meaning 



DET [ ACH ] 



END 
LAS [ T ] 
LEG [ AL ] 

NOT [ ICE text 

PAU[ SE] 



Valid only under these conditions: 
o If RESTOR is attached 
o OPSER is running 



The RESTOR listing file is not on the 
terminal to which RESTOR is attached 

No messages are currently pending for the 
specific RESTOR job 



If these conditions are met, RESTOR detaches and 
is given a receiver identification of BACKnn 
where nn is its job number. All further 
interaction with RESTOR is done through OPSER. 

Finishes transferring the current file and 
terminates processing. 

At the OSC, prints the most recent message 
generated by this RESTOR job. 

At the OSC, prints a list of commands that can 
legally be given for this phase of the RESTOR 
run . 

Inserts the specified text in the RESTOR listing 
file. Precedes the text with the heading NOTICE 
FROM OPERATOR. 

Places RESTOR in a sleep state, during which it 
responds to most commands, continues normal 
processing in response to a CONTINUE command, and 
terminates processing on an ABORT command. 



STA[ TUS ] 



Prints a status report for this RESTOR job. 



While RESTOR is running detached, it generates all of its requests for 
operator interaction through OPSER as messages. The operator uses the 
INTERRUPT command to respond to such requests. See the RSTS/E 
Utilities Reference Manual for the proper responses to RESTOR 
requests . 
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Number Conversion 



Many applications require a number based on bit values in a PDP-11 
word. Table B-l lists the octal and decimal values for each bit in 
the PDP-11 word. 



Table B-l: Bit Values in the PDP-11 Word 



1 1 

1 Bit | 


Octal | 


Decimal 


Number | 


Value | 


Value 


+ + - 






| 


1 | 


1 


I 1 1 


2 1 


2 


i 2 | 


4 1 


4 


1 3 | 


10 | 


8 


1 4 | 


20 | 


16 


1 5 | 


40 | 


32 


1 6 | 


100 | 


64 


1 7 | 


200 | 


128 


1 8 | 


400 | 


256 


1 9 | 


1000 | 


512 


1 io | 


2000 | 


1024 


1 11 1 


4000 | 


2048 


1 12 | 


10000 | 


4096 


1 13 1 


20000 | 


8192 


1 14 | 


40000 j 


16384 


1 15 1 


100000 | 


32768 


+ + - 


+ 
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Append ix C 
Disk Device Sizes 



Table C-1 lists the device cluster size and device size (in 512-byte 
blocks) for each disk that RSTS/E supports. All values are in 
decimal . 



Table C-1: Disk Device Sizes 



Device 



Total 



Disk | 
Type | 


Cluster 
Size 


| Available 
| Blocks 


+ 




- + 


RX50 | 


1 


| 799 


RK05 | 


1 


| 4800 


RK05F 1 


1 


| 4800 for each unit; 






j 2 units per drive 


RL01 | 


1 


| 10220 


RL02 | 


1 


| 20457 


RD51 | 


1 


| 21599 


RD52 | 


1 


| 60479 


RC25 


1 


| 50901 for each unit; 






| 2 units per drive 


RK06 | 


1 


| 27104 


RK07 


.1 


| 53761 


RP02 | 


2 


| 39998 


RP03 | 


2 


| 79998 


RM02 | 


4 


| 131648 


RM03 j 


4 


| 131648 


RP04 | 


4 


| 171796 


RP05 | 


4 


| 171796 


RA80 | 


4 


| 237208 


RM80 | 


4 


| 242572 


RP06 | 


8 


| 340664 


RA60 


8 


| 400168 


RM05 | 


8 


| 500352 


RA81 


16 


1 891056 
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Appendix D 
General RSTS/E Messages 



This appendix lists the general messages that you may encounter when 
using RSTS/E. Table D-l also indicates the probable cause of the 
error in your use of a command or system program. 

If you perform DECnet/E operations, you may receive messages that are 
described in DECnet/E documentation but not in this appendix. In 
addition, the utility programs that support DCL can produce messages 
not all of which are listed here. Those messages are listed in the 
RSTS/E Utilities Reference Manual. 



Special Characters Used in Error Messages 

The question mark (?), double question mark (??), and percent sign (%) 
characters preceding a message indicate its severity. A single 
question mark precedes standard error messages, which means that the 
command failed to do what you asked but you can continue. For 
example: 

?Too many parameters 

In this case, the command failed because you included too many 
parameters . 

A double question mark precedes severe error messages, which means 
that the command failed to do what you asked and you cannot continue. 
For example: 

??Fatal system I/O failure 

By contrast, the percent sign identifies a warning message, which 
means that the command may not have worked as you intended. For 
example : 

%Logical name has not been assigned 
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General RSTS/E Messages 



In this case, the MOUNT command worked but no logical name was 
assigned to the device. 

Informational messages do not have a preceding character; they provide 
extra details about the effects of a command. For example: 

Queue file being reorganized - please wait... 

This message informs you that, as a result of your command, the file 
is being reorganized. 

Angle brackets ( < > ) surrounding text indicate a place holder for 
what the system inserts when an error message occurs. 

Table D-l lists the messages that you can get when using RSTS/E and 
the probable causes. 



Table D-l: General RSTS/E Messages 

+ + 

| Message and Meaning | 

+ + 

| ?Account or device in use j 

I The device cannot be mounted or dismounted because it is j 

| open or has one or more open files. This error can also j 

| occur when a user attempts to access a non-shared disk from j 

| a job other than the one specified in the /NOSHARE=n | 

| command. j 

| ?Additional argument required j 

| You did not specify enough arguments in the DCL function. j 

| ?Additional qualifier required | 

| You did not include a qualifier required in a command. | 

| %All volumes must be of the same media type | 

I 7 I 

| You attempted to write a Backup set on both disk and tape. | 

| ?Ambiguous keyword | 

| You abbreviated a keyword to short; DCL cannot distinguish j 

| it from other keywords. j 
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Table D-l: General RSTS/E Messages ( Cont . ) 

+ + 

| Message and Meaning | 

+ + 

| %An unrecognized character was typed - try again | 

| There were extra characters in the command line that BACKUP | 

| did not recognize as meaningful. I 

| PArgument not allowed I 

| You used an argument with a qualifier that does not accept | 

| one . I 

| ?Argument required | 

I An argument was not supplied with a qualifier which required | 

| one. For example, /SINCE=, without an argument, would | 

I generate this error. | 

| The user did not supply an argument to a DCL function that | 

| required one. I 

| ??Bad directory for device I 

| The directory of the device referenced is in an unreadable | 

| format. For example, the tape format differs from the format | 

| you specified with the MOUNT command. I 

I %Block header CRC error detected for block | 

I Although this block was read successfully by the source | 

| device, BACKUP discovered that there was an error in the | 

| block. BACKUP will attempt to recover the data using | 

| recovery data if possible. I 

I PBlocksize must be a multiple of <16 or 512> I 

| An invalid blocksize was specified. Blocksize must be a | 

| multiple of 16 for tape and 512 for disk. I 

| ?Can't access terminal <error text> I 

I An error occurred while attempting to access the terminal to | 

I send the setup file using the SET TERMINAL command. I 

| ?Can't find file or account I 

| Either the account or file does not exist, or you typed a | 

I file specification incorrectly. I 
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Table D-l: General RSTS/E Messages (Cont.) 

+ - - - - + 

| Message and Meaning | 

+ - + 

j ?Can't mount a private disk as public | 

| You tried to mount as public (using the MOUNT command's j 

| /PUBLIC qualifier) a disk that was initialized as private. | 

| ?Can't rebuild disk because device is write protected | 

| A user with MOUNT privilege attempted to rebuild a disk | 

| (using the MOUNT command's /REBUILD qualifier), and the | 

| drive is write protected. Therefore, the mount and rebuild | 

| operations fail. | 

| ?Command not installed j 

| You typed a DCL command that has not been installed on your | 

| system. The DCL keyboard monitor could not find the utility | 

| needed to carry out your command. This message can also be | 

| displayed if you type a remote file specification in a | 

| command that allows remote file specifications, but your | 

| system does not have DECnet/E. | 

| ?Command requires <privilege> privilege | 

| The user does not have the appropriate privileges to | 

| complete an operation. | 

j ?Command too long j 

| The length of the command, including continuation lines, j 

| exceeds the maximum allowed for the command. Or, the length j 

| of the translated command string exceeds the maximum allowed | 

| for the command. | 

| For example, this message occurs with the LINK command in j 

| either of two cases: j 

| o The text you typed in response to the $ prompt and the j 

| Files: or Root files: prompt added up to more than 127 | 

| characters after translation. | 

| o With LINK/COBOL, the text was longer than 80 characters j 

I after translation. 
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Table D-l: General RSTS/E Messages (Cont. ) 



+ 



+ 



Message and Meaning 



+ 



+ 



%Command will proceed as requested 

The user's symbol tables could not be written out to the DCL 
work file, but the command will be processed. The user may 
be over quota. Corrective action should be taken before the 
user continues processing. 

?Comma required 

A DCL function required two or more arguments and .they were 
not separated by a comma. 

?Conflicting arguments 

Multiple arguments to a qualifier conflict. For example, 
both an AFTER date and an exact date were specified to the 
/CREATED qualifier. 

?Conflicting elements 

You specified qualifiers or parameters in a command that do 
not agree in type (for example, a print qualifier with a 
batch server ) . 

?CPU limit exceeds queue's maximum 

You specified a /CPU_LIMIT value in a SUBMIT command larger 
than the maximum allowed for the queue. 

?Data error on device 

One or more characters may have been transmitted incorrectly 
due to a parity error, bad punch combination on a card, or 
similar error. 

?Data error or incorrect density 

This message occurs for one of the following reasons: 



o 



You specified the incorrect density. 



o 



The data on the tape is damaged. 



o 



The tape drive is faulty. 
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Table D-l: General RSTS/E Messages (Cont.) 
+ - ■ 



| Message and Meaning 
+ 



?Default macro for KBn: does not exist 

The /INQUIRE command could not recognize the terminal and 
there was no default macro specified for this keyboard in 
the default file, TERDFL . SYS . You should supply a default 
macro for the keyboard. Until that is done, the keyboard's 
characteristics have to be set manually. 

Density of <density> BPI not available, using <density> BPI 
instead 

The requested density was not available on the drive. BACKUP 
reports the density that is being used. 

?Device does not exist 

The device name you specified does not exist on your system. 

%Device hung or write locked 
%Dismount will proceed as requested 

You attempted to dismount a disk that has been physically 
dismounted. However, the logical dismount will succeed. 

?Device hung or write locked 

Check the hardware condition of the device requested. 
Possible causes of. this error include: 

o A line printer out of paper 

o A disk drive being off line 

o A disk is dual-ported and is not write -protected 
%Device in use 

You specified /NOSHAREABLE in an INITIALIZE/SERVER command; 
however, the print server's device is not available or no 
pseudo-keyboards are currently available for the batch 
server. PBS allocates the device as soon as it becomes 
available . 



D-6 



General RSTS/E Messages 



Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ?Device is not a terminal | 

| A device other than a terminal was specified. Only specify j 

| keyboards. j 

| PDevice is restricted j 

| This message occurs when a user without DEVICE privilege | 

| attempts to open files on a disk restricted to users with j 

| DEVICE privilege. | 

| ?Device must be disk | 

| You specified a file on a nondisk device, where a disk j 

| device is required. j 

| ?Device must be disk or tape j 

| The device specified was not a disk or tape, and only disk j 

| or tape is valid. j 

| ?Device name may not be specified j 

| A device name is not valid at this point, but one was | 

| specified. | 

| ?Device not available j 

| The specified device exists on the system, but an attempt to j 

| allocate or use it is prohibited for one of the following j 

| reasons: | 

| o The device is currently reserved by another job. | 

| o The device requires privilege for ownership and you do j 

| not have the necessary privilege. | 

| o The device or its controller has been disabled by the | 

| system manager. j 

| o The device is a keyboard line for pseudo keyboard use | 

| only. j 
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Table D-l: General RSTS/E Messages (Cont.) 

+ - + 

| Message and Meaning | 

+ - + 

| PDevice not file - structured I 

| An attempt was made to access a device, other than a disk | 

| drive or magnetic tape drive, as a file - structured device. | 

| ?Device not write protected I 

| You specified the /NOWRITE qualifier when you tried to mount | 

| a magnetic tape, but the device is not write protected. | 

| Write protect the device by removing the plastic ring from | 

| the magnetic tape hub. I 

| ?Device offline I 

| You tried to use a tape or disk, but the device is off line. | 

| %Device write protected I 

| The magnetic tape or disk is protected against write access. | 

| Therefore, you can only read files on the device, but cannot | 

| write (perform output) to the device. If you want to write | 

| to the device, first write enable the device, next dismount | 

| the device, and then mount the device again. | 

| ?Device write protected I 

| You requested write access to a device that is write | 

| protected. Write enable the device and then retype the | 

| command. I 

I %Directory attributes verification failure for directory | 

| <directory> I 

| The directory attributes stored in the Backup set are | 

| different from the directory attributes as stored in the | 

| directory structure. This is a verification mismatch. | 

| ?Directory does not exist I 

| A file specification indicates a directory that does not | 

| exist on the particular private disk. Or, a wildcard | 

| directory specification failed to produce a match on the | 

| disk specified. This error can occur only with private | 

disks. I 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ??Disk error during swap | 

| A hardware error occurs when your job is swapped into or out | 

| of memory. The contents of the job area are lost, but the | 

| job remains logged in to the system and returns to DCL. | 

I Report such occurrences to the system manager. j 

| Disk is being rebuilt - wait... | 

| This informational message is displayed when a user attempts | 

| to rebuild a disk. The disk is logically mounted when the | 

| rebuilding operation is complete. | 

| ?Disk is mounted non-shared | 

| A user attempted to dismount a disk that was mounted as | 

| nonshared (by a different job) by specifying /PUBLIC in the | 

| DISMOUNT command. j 

| ?Disk is mounted private or non-shared | 

| A user attempted to dismount a disk that was mounted as j 

| nonshared (by the same job) or private by specifying /PUBLIC | 

j in the DISMOUNT command. | 

| ?Disk is mounted public I 

| A user with MOUNT privilege attempted to dismount a public j 

| disk that was mounted as public, without specifying /PUBLIC j 

| in the DISMOUNT command, so the dismount fails. j 

| %Disk is mounted read-only j 

| This warning occurs if you do not specify either read or j 

| write access (/NOWRITE or /WRITE) when mounting a disk j 

| initialized as read-only. Therefore, you are granted read | 

| access only. j 

| ?Disk is NOSHARE to another job; can't verify pack-id | 

| A user with MOUNT privilege attempted to mount a disk that | 

| is mounted /NOSHARE to another job. | 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ - - + 

I %Disk is restricted and mounted non-shared, read-only | 

| A user specified /NOREBUILD (to suppress rebuilding) and j 

I /NOSHARE in the MOUNT command and the disk was dirty. | 

| Therefore, the disk is mounted nonshared and restricted, and | 

| read-only access is granted. ("Restricted" means that access | 

| is allowed only to users with DEVICE privilege . ) | 

| %Disk is restricted and mounted private, read-only j 

| A user specified /NOREBUILD (to suppress rebuilding) and | 

j /SHARE in the MOUNT command and the disk was dirty. j 

j Therefore, the disk is mounted nonshared and restricted, and | 

| read-only access is granted. ("Restricted" means that access | 

| is allowed only to users with DEVICE privilege.) | 

| ?Disk needs rebuilding but device is write protected | 

j A user with MOUNT privilege attempted to mount a dirty disk j 

| (and did not specify /REBUILD or /NOREBUILD), but the device | 

| is write protected and the automatic rebuilding cannot be | 

| performed. Therefore, the mount fails. | 

j ?Disk needs rebuilding but you do not have MOUNT privilege j 

| This message occurs when a user without MOUNT privilege j 

| tries to mount a private disk that was not logically | 

| dismounted. The system manager can correct the situation by j 

| rebuilding the disk. | 

j ?Disk needs rebuilding, so it can not be NORESTRICT | 

| This message occurs when a user with MOUNT privilege tries | 

| to mount a dirty disk with both /NOREBUILD and /NORESTRICT | 

| qualifiers. j 

| ?Disk pack is not mounted | 

| The DISMOUNT command was attempted, but the disk pack was | 

| not mounted on the specified disk drive. | 

| ??Disk pack mount error | 

| Fatal disk mounting error. The disk is corrupt and cannot be j 

| successfully mounted with the MOUNT command. j 
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Table D-l: General RSTS/E Messages (Cont.) 

+ - - + 

| Message and Meaning | 

+ + 

| ?Division by zero j 

| The expression specified by the user attempted to divide by | 

| zero. | 

| ?Do not specify file name or type | 

| This message can occur with the first parameter of the | 

| ASSIGN command. Remember to use a space between the first | 

| parameter (the string you assign) and the second parameter | 

| (the name you assign it). For example, "ASSIGN DR3 : X", not | 

I "ASSIGN DR3 : X" . | 

| %Dual-ported disk, may still be mounted on another system | 

| You specified a disk in a DISMOUNT command that is I 

| dual -ported. So, it may still be mounted on another system. | 

| ?Equal sign required | 

| You used a qualifier that requires an argument, but you did | 

| not give an argument. I 

| ?Error assigning Backup set device I 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to assign the Backup set device. This message will | 

| be followed by another message describing the problem. | 

| ?Error closing Backup set | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to close the Backup set. A message detailing the | 

j problem will follow. j 

j ?Error creating directory <directory> | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to create a directory. A message detailing the | 

I problem will follow. j 

| ?Error creating disk initialization command file | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to create the command file used to initialize disks. j 

| A message detailing the problem will follow. | 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ?Error creating dynamic region j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to create a dynamic region. A message detailing the j 

| problem will follow. | 

| ?Error creating job to initialize disk | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to create a job, used to initialize disks. A message j 

| detailing the problem will follow. | 

| ?Error creating output directory j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to create a directory. A message detailing the j 

| problem will follow. j 

| ?Error deassigning Backup set device j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to deassign the Backup set device. A message j 

| detailing the problem will follow. | 

| ?Error dismounting disk to initialize it j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to dismount a disk so that it can be reinitialized. | 

| A message detailing the problem will follow. j 

| PError in forms definition <forms-name> j 

| <error message> j 

| An error, as the error message in the second line describes, j 

| was discovered in the forms definition displayed. j 

| ?Error initializing Backup set j 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to initialize the Backup set. This message will be j 

| followed by another message detailing the problem. j 
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Table D-l: General RSTS/E Messages (Cont.) 

+ - 

| Message and Meaning 



?Error mounting output disk 

This message indicates that the monitor has reported an 
error as a result of BACKUP'S mount request. It will be 
followed by an error detailing the problem. 

?Error mounting Backup set 



The RSTS/E monitor reported an error in response to BACKUP'S 
request to mount the Backup set. A message detailing the 
problem will follow. 



?Error number nn 



An I/O error occurred while the system was attempting to 
retrieve an error message. Possible causes could be that the 
device containing the system error file (ERR. SYS) is off 
line, or that the system error file contains a bad block. 

This is a serious error, and should be reported to the 
system manager. 

?Error obtaining file flags for file <filename> for verification 

The RSTS/E monitor reported an error when BACKUP requested 
to find out what the file flags for a file to verify were 
set to. This message will be followed by another message 
describing the problem. 

?Error opening disk non - file - structured to initialize it 
<error message> 

This message occurs when BACKUP is requested to initialize a 
disk and the RSTS/E monitor is unable to open it in 
non- file - structured mode. This generally happens because a 
disk unit is off line or no disk is mounted in the drive. 
This can also occur for other reasons, such as no access to 
non- file - structured disks or other device specific errors. 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| PError opening file <filename> for input - skipping rest of | 

| directory | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to open a file in the directory (note that since the | 

| filename is unknown at the time, this may contain | 

| wildcards). A message detailing the problem will follow. | 

I Since BACKUP scans the directory sequentially, the rest of | 

| the directory will be skipped. | 

| ?Error opening file <filename> for output I 

| The monitor reported an error to BACKUP when it was trying | 

| to create a file. This message will be followed by a message | 

| describing the problem. | 

| ?Error opening file <filename> for verification | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to open a file for verification. This message will | 

| be followed by another message detailing the problem. j 

| ?Error opening PBS file <file-spec> j 

| <error message> | 

| An error, as the error message in the second line describes, | 

| occurred opening the PBS file indicated. | 

| ?Error opening Backup set I 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to open the Backup set. Another message will follow, | 

| describing the problem. | 

| ?Error opening Backup set non-file structured | 

j The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to open the Backup set device for control purposes. | 

| An error follows which will detail the problem. | 

| ?Error performing PPN lookup I 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to look up PPNs to back up. A message detailing the | 

| problem will follow. I 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ?Error reading accounting data for directory <directory> j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read the accounting data for a directory. A j 

| message detailing the problem will follow. j 

| ?Error reading directory attributes for directory <directory> | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read directory attributes. A message detailing | 

| the problem will follow. | 

| ?Error reading file attributes for file <filename> | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read file attributes for a file being backed up. j 

| A message detailing the problem will follow. j 

| ?Error reading file <filename> block <block> | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read file data. A message detailing the problem | 

| will follow. | 

j PError reading output volume label j 

| The monitor reported an error to BACKUP in response to a j 

| request to determine the volume label of the output device. | 

| This message will be followed by a message detailing the | 

| problem. | 

j ?Error reading Backup set | 

I This message indicates that an error was reported by the j 

| monitor to BACKUP when attempting to read the Backup set. It j 

| will be followed by a device specific error message | 

| describing the problem. In addition, it may be followed by | 

| other messages if BACKUP is unable to recover from the lost j 

| data. j 

| ?Error reading Backup set attributes j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read the Backup set attributes. An error follows j 

| which will detail the problem. | 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ?Error reading Backup set volume label | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to read the Backup set label. A message detailing | 

| the problem follows. | 

I ?Error restoring file dates for file <filename> | 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| attempt to restore file dates. Another message describing | 

| the problem follows this message. | 

| ?Error rewinding Backup set j 

| BACKUP encountered an error when asking the monitor to | 

| rewind the Backup set. A message detailing the problem | 

j follows. j 

I ?Error setting end- of -volume flag | 

j The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to set the end-of -volume flag. A message detailing | 

j the problem follows. j 

| ?Error setting file flags for file <filename> j 

j The RSTS/E monitor reported an error in response to BACKUP'S | 

| attempt to set file flags (caching, protected, etc.). | 

| Another message describing the problem follows this message. | 

| ?Error setting RTS name for file <filename> j 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

j attempt to set the runtime system name for a file. Another j 

| message describing the problem follows this message. j 

| <error text> opening setup file <filename> | 

| An error occurred while trying to gain access to the setup j 

| file. | 

| <error text> opening speed file j 

| An error occurred while trying to gain access to the speed | 

| file. The speed is not set and the rest of the SET TERMINAL j 

I command is executed. I 
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Table D-l: General RSTS/E Messages (Cont.) 

+ - + 

| Message and Meaning | 

+ - + 

| <error text> opening/reading default file I 

| An error occurred while processing the default file. | 

| <error text> reading setup file <filename> I 

| An error occurred while processing the setup file. | 

I <error text> reading speed file I 

| An error occurred while processing the speed file. The speed | 

| is not set and the rest of the SET TERMINAL command is | 

| executed. | 

| ?Error verifying directory attributes for directory <directory> | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to read directory attributes for verification. | 

| Another message describing the problem follows this message. | 

| ?Error verifying directory <directory> | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to obtain directory information for verification. | 

| Another message describing the problem follows this message. | 

| ?Error writing directory attributes for directory <directory> | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to write directory attributes. Another message | 

| describing the problem follows this message. I 

| PError writing file attributes for file <filename>, I 

| The monitor reported an error to BACKUP when it was trying | 

| to restore file attributes. Another message describing the | 

| problem follows this message. I 

| ?Error writing Backup set I 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to write to the Backup set. Another message | 

| describing the problem follows this message. I 
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Table D-l: General RSTS/E Messages (Cont.) 

+ + 

| Message and Meaning | 

+ + 

| ?Error writing Backup set attributes j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to write the Backup set attributes. Another message | 

| describing the problem follows this message. | 

| ?Error writing to disk initialization command file | 

| The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to write to the command file used to initialize j 

| disks .Another message describing the problem follows this | 

| message. j 

| ?Error writing to list file j 

| The RSTS/E monitor reported an error in response to BACKUP'S j 

| request to write to the list file. Another message j 

| describing the problem follows this message. j 

| PExtra file data found in file <filename> - ignoring it j 

| There were file data blocks for blocks beyond the written j 

| end of file. If this was not accompanied by other messages, j 

| submit a SPR with a copy of the Backup set. j 

| ??Fatal system I/O failure | 

| An I/O error has occurred on the system level. The results j 

| of the last command are unpredictable. This error is caused j 

| by a hardware condition. Report such occurrences to your j 

| system manager. | 

| ?File attributes for file <filename> may be incorrect j 

| If BACKUP has used recovery data to restore a file, there is | 

| a chance that the file attributes may not be correct. If j 

| this is a possibility, BACKUP informs the user with this | 

| message. j 

| ?File data block for file <filename> duplicated in Backup set j 

| A file block was found to be duplicated in the Backup set. j 

| If this was not accompanied by other errors, submit a SPR | 

| containing a copy of the Backup set. j 
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j ?File data block for file <filename> missing in Backup set | 

| A file block was found to be missing in the Backup set. If | 

| this was not accompanied by other errors, submit a SPR | 

| containing a copy of the Backup set. | 

| ?File data in file may be incorrect | 

| This message can occur if there are several missing blocks | 

j from a Backup set. It should be accompanied by other | 

| messages, describing the cause of the problem. If not, | 

| submit a SPR with a copy of the Backup set. | 

| ?File does not exist | 

| This message occurs for one of the following reasons: | 

| o An input file that must be present is not present. j 

| o A wildcard file specification does not match any files. | 

| o A file is not accessible because of its assigned | 

| protection code. j 

| File <filename> not replaced | 

| This is an informational message, which reports that a file j 

| was not restored because there was a file of the same name | 

| already existing and you did not use the /REPLACE qualifier, j 

| File <filename> restored as non- contiguous j 

| The RSTS/E monitor was unable to locate contiguous space to | 

| restore a contiguous file as contiguous. | 

| ?File name attribute invalid - skipping file | 

| If this Backup set was written by RSTS/E BACKUP, submit a j 

| SPR containing a copy of the Backup set. If this Backup set j 

| was written by any other operating system, it indicates that | 

| the file name could not be mapped into a RSTS/E name, and | 

| was skipped. Rename the file on the source system to | 

| something which will fit into the RSTS/E file naming scheme. j 
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| ?File name attribute missing - skipping file | 

| Submit a SPR with a copy of the Backup set. I 

| ?File name required I 

| A file specification you typed does not include a file name, | 

| but one is needed. | 

| ?File specification required I 

| This error occurs if you specify node:: without a file | 

I specification (except with DIRECTORY). It also occurs if you | 

| have two commas with no characters between them in a file | 

| specification list. I 

| ?Files cannot be on different nodes I 

| This message occurs with network operations. Each input file | 

| specification you include in a network command must be on | 

| the same node. I 

| ?Form <form-name> does not exist I 

| The form name you specified was not defined by the system | 

| manager. See your system manager to find out what form names | 

| are available. I 

| ?Forms Definition File does not exist I 

j The forms definition file, PBS$ : FORMS . SYS does not exist. | 

| See your system manager. I 

| PForms not defined [for server <server -name) ] I 

| The forms you specified could not be found in the forms | 

| definition file. See your system manager. I 

| %ID label ignored I 

| You mounted a tape in DOS format and specified an ID label. | 

| Identification labels are not encoded on DOS tapes; | 

| therefore, the label you specified is not recognized by the | 
MOUNT command. 
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I %ID label should be specified when you mount an ANSI tape | 

| You mounted a tape in ANSI format, but did not specify the | 

| tape identification label. DIGITAL recommends that you j 

I specify the identification label. Thus, the MOUNT command | 

| can verify that the tape you selected has been mounted. | 

| ?ID labels don't match | 

| The identification label you specified does not match the | 

| identification label encoded on the tape. To correct the | 

| problem, specify the correct identification label. If you do | 

| not know what identification label is encoded on the tape, | 

| you can omit the ID label from the MOUNT command. | 

| ?Illegal byte count for I/O | 

| The range of memory starting at the load address given is | 

| not available. Refer to the memory status report of a | 

I display program ( SYSTAT or DISPLY) to select an available j 

I range of memory. Note that you can also use the SHOW MEMORY | 

| command. | 

| ?Illegal filename | 

j The file name given in the command contains characters other j 

| than alphabetic or numeric characters. I 

| ?Illegal switch usage | 

| A CCL command contains an error in an otherwise valid CCL | 

I switch (qualifier). For example, you cannot use the /SI:n | 

j switch without a value for n or a colon; or you cannot j 

| specify more than one of the same type of CCL switch. | 

| ?Illegal value - n | 

| The swap file number specified is not 0, 1, or 3. (The swap | 

j file 2 already exists on the system disk and can not be | 

| added. ) I 
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| ?Impossible density for this device | 

| You tried to mount or initialize a tape, but specified a | 

| density not available on the tape drive you used. To correct | 

| the problem, use another drive or specify a different | 

| density. | 

| ?Incorrect density | 

| You specified a density different from the tape's density. | 

| ?Incorrect density or uninitialized tape I 

| This message can occur for the following reasons: I 

| o You tried to mount a tape that had not been | 

| initialized. | 

| o You specified an incorrect density. | 

| If the tape has not been initialized, use the INITIALIZE | 

| command. Otherwise, specify the correct density. I 

| ?Invalid account | 

| The account specified was not valid either containing | 

| invalid characters (for example, or an invalid format | 

| (for example, [1,2345]). | 

| ?Invalid argument | 

| This error can occur when you use a qualifier in the form | 

| /qualif ier=argument . The qualifier you used is spelled | 

| properly, and the equal sign (=) or colon (:) is present; | 

| however, the argument is either missing or syntactically | 

| invalid. | 

| RSTS/E displays this error message when there is no more | 

| specific message to describe the syntax error. | 

| ?Invalid at interactive level I 

| You specified a command that is invalid at the interactive | 

| level. (For example, GOTO LABEL) | 
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| ?Invalid attribute length - attribute skipped j 

| If you get this message, submit an SPR with a copy of the | 

| Backup set that generated the error. | 

| ?Invalid attribute - attribute skipped | 

| This message indicates that the version number of a record | 

| was higher than the highest version known to BACKUP. If this | 

| error occurs trying to restore a Backup set written by a | 

| newer version of BACKUP on an older version of BACKUP, the | 

| operation may not work properly. If the version of BACKUP | 

| writing the tape is older or the same as the one doing the | 

| RESTORE, submit an SPR with a copy of the Backup set that | 

| generated the error. | 

| ?Invalid BATCH command | 

| Although the command is valid in interactive mode, the | 

| command is not a valid BATCH command because it implies or | 

| requires interaction with the user. (For example, INQUIRE, | 

I SET NODATA) | 

| ?Invalid CCL command | 

| You used the CCL prefix followed by a command that is not | 

I installed as a CCL command on your system. | 

| ?Invalid channel number | 

| The I/O channel number specified was invalid. Channel | 

| numbers can range from 1 to 13 on OPEN, READ and CLOSE j 

| commands, and from to 13 on WRITE commands. j 

| ?Invalid character | 

| You typed an invalid punctuation character. | 

| ?Invalid command | 

| The command name you gave is not a DCL command, and is not | 

| defined on your system as a CCL command. Or, the line begins | 

| with a punctuation character rather than with a keyword. | 
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I ?Invalid date | 

| A date either has improper syntax, represents a nonexistent j 

| date (for example, 30-Feb), or represents a date before 1970 | 

I or after 1999. j 

| ?Invalid density - n j 

| You tried to mount or initialize a tape, but specified a | 

j density other than 800 or 1600 bpi . The n is the density you j 

| specified. | 

| ?Invalid device j 

I The device specified could not be found in the list of j 

| standard devices or in the user-defined macros ( TERMAC . SYS ) . | 

I Specify a valid device. j 

| %Invalid directory attribute record - skipping | 

| This message indicates that a directory attribute code found j 

| in a Backup set was unknown to BACKUP. If this error occurs j 

| trying to restore a Backup set written by a newer version of j 

| BACKUP on an older version of BACKUP, the operation may not | 

| work properly. If the version of BACKUP writing the tape is j 

| older or the same as the one doing the RESTORE, submit an | 

| SPR with a copy of the Backup set that generated the error. j 

| ?Invalid entry name | 

| The entry name you specified is invalid. | 

j ?Invalid expression j 

| This covers a range of expression problems. The most common j 

| of these is an expression ending in an operator without | 

| supplying a second operand (for example, A = B *). j 

| ?lnvalid file specification j 

| A local file specification has improper syntax. | 

| ?Invalid fill factor j 

| A fill factor was specified that was less than or greater j 

I than 6 . I 
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| ?Invalid form definition I 

j The definition of the specified form contains an invalid | 

| keyword or keyword argument. I 

| ?Invalid form name I 

| The form name you specified is either longer than six | 

j characters or consists of one or more nonalphanumer ic | 

| characters. I 

| ?Invalid function name I 

| The function name specified after F$ is invalid. The minimum | 

| abbreviation point is not met for the function (for example, | 

| F$LE is not valid because of F$LEFT and F$LEN) . I 

| %Invalid keyboard numbers n , n in default file I 

| The numbers you specified in the default file were less than j 

| 0, greater than 127, or the first number of the range is | 

| greater than the second number of the range. I 

| %Invalid keyboard numbers n , n in speed file I 

j The numbers you specified in the speed file were less than | 

| 0, greater than 127, or the first number of the range is j 

| greater than the second number of the range. I 

| ?Invalid keyword I 

| The keyword is not recognized. This error occurs with | 

j keywords that are not qualifiers and are not command names. j 

| (For example, it can occur with the options of SET and SHOW, | 

| and with qualifier values that are keywords.) I 

| ?Invalid label I 

| The label specified in the command procedure contains | 

j invalid characters. I 

| ?Invalid node name I 

I The node name field of the file specification contained | 

I invalid characters. I 
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| PInvalid operation on system disk | 

I You specified an operation on the system disk which is j 

| invalid (for example, DISMOUNT). | 

| ?Invalid operator | 

j The operator you specified in the expression is not a | 

| defined logical, arithmetic, string, arithmetic comparison | 

| or string comparison operator. | 

| ?Invalid PPN | 

| The project-programmer number (PPN) you specified does not | 

| have valid syntax. | 

| PInvalid print device | 

| The device you specified is not a valid print device because j 

| it is not a line printer or terminal. | 

| ?Invalid private delimiter | 

| The delimiter you specified was not in one of the correct | 

| formats. | 

| ?Invalid qualifier | 

| The qualifier keyword is not valid in the command you typed. | 

j (This message may indicate an error in spelling or typing.) | 

j ?Invalid qualifier for disk | 

| This message occurs when you specify an invalid qualifier | 

| for disks. For example, /FORMAT=ANS I (applies only to | 

| magnetic tapes). I 

| ?Invalid qualifier for tape I 

| This message occurs when you specify an invalid qualifier | 

| for tapes. For example, /PRIVATE (applies only to disks). | 

| PInvalid queue name I 

| The queue name you specified is invalid. | 
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| ?Invalid record length in Backup set - record skipped | 

| If you get this message, submit an SPR with a copy of the | 

| Backup set that generated the error. | 

| %Invalid Backup set attributes - can't use it j 

| The Backup set does not have the attributes correct for a | 

I BACKUP Backup set. | 

| ?Invalid server name | 

| The server name you specified is invalid. | 

| PInvalid speed | 

j The speed specified was not a valid speed for the interface | 

| of the terminal. Only specify speeds that the interface | 

| supports. | 

| PInvalid symbol name | 

| You specified a symbol name that contains invalid | 

| characters. j 

| PInvalid time j 

| A time either has improper syntax or represents a | 

j nonexistent time (like 25:00 or 13:00PM). | 

| PInvalid width | 

| You specified a width that was less than 1 or greater than j 

| 254. | 

| PInvalid with network file specification | 

| You gave a network file specification in one of the commands j 

| that accepts them ( RENAME , COPY, and so on), but you also j 

| gave a qualifier that can be used only with local | 

| operations. j 



D-27 



General RSTS/E Messages 



Table D-l: General RSTS/E Messages (Cont.) 

+ - + 

I Message and Meaning | 

+ + 

| ?I/0 to detached keyboard | 

| This message can result from one of two actions: | 

| o You tried to perform I/O with a terminal line that is | 

| used for dial-up terminals, but nobody was dialed in. | 

| o Your job became detached (perhaps because you were | 

| dialed in and your line was later hung up) and then | 

| tried to perform I/O with the terminal. | 

| The second situation either causes the job to hibernate or | 

| causes this error condition, after which the job hibernates. | 

| You see this message when you subsequently attach to the | 

I job. | 

| ?Keyword required | 

| You typed nonalphanumeric characters when a keyword is | 

| needed instead. (If you type alphanumeric characters without | 

I a valid keyword, you receive the error message, PInvalid | 

| keyword . ) | 

I ?Label already defined j 

| A label was defined more than once in an indirect command | 

| procedure. | 

| ?Label too long | 

| The label you specified in the indirect command procedure | 

| was longer than 255 characters. | 

| ?Log file already open | 

| A log file was already currently open when you attempted to | 

I open another log file using the OPEN/LOG__FILE command. | 

| ?Log file not currently open | 

| You attempted to enable or disable logging using the SET | 

| LOG__FILE command, and a log file did not exist. I 
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| ?Log file print queue closed j 

| The print queue required for a SUBMIT command's /LOG_QUEUE j 

| qualifier is closed or marked for deletion. Use a different j 

| print queue for the log file. | 

| ?Log file print queue does not exist | 

| The print queue you specified with the /LOG_QUEUE qualifier j 

| in a SUBMIT command does not exist. Specify a different | 

| queue . | 

| %Logical name has not been assigned j 

| This warning can be displayed for one of two reasons: | 

| o You had INSTAL privilege and specified a logical name j 

| that was not assigned as a system logical. (This means j 

| that neither the alternate logical name nor the pack-id j 

| label were assigned.) j 

| o You did not have INSTAL privilege and specified an j 

| alternate logical name when attempting to mount a disk. | 

| The mount succeeds in both cases, but the logical name is | 

| not assigned. | 

| ?Magtape record length error j 

| When performing input from magnetic tape, the record on tape j 

| was found to be longer than the buffer designated to handle j 

| the record. j 

| ?Magtape select error j 

| When access to a magnetic tape drive was attempted, the j 

| selected unit was found to be off line. This error can occur | 

| when you transfer data to or from a tape. j 

| ?Map or executable file required j 

I With LINK, you specified /NOEXECUTABLE and did not specify a j 

| map file. j 
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| ??Maximum memory exceeded | 

| This is a nonrecoverable RSTS/E error caused by the | 

| following conditions: | 

| o While loading a program into memory, the job's private | 

| maximum memory size was reached. | 

| o While executing a program, the system required more | 

| memory for string or I/O buffer space, and the job's | 

| private maximum memory size or the system maximum was | 

| reached. | 

| ?Missing closing apostrophe | 

| The user did not specify matching apostrophes ('... ' ) when | 

| requesting apostrophe substitution. | 

| ?Missing closing bracket | 

| This error can occur in a local or remote file | 

| specification. There is a left bracket ([) or left angle j 

| bracket (<), but no right bracket (]) or right angle bracket | 

I (>). I 

| ?Missing closing quote | 

| A quotation mark ( " ) is not matched with another quotation | 

| mark. (This error can occur in remote file specifications.) | 

| ?Missing device or file name | 

| The command must contain either a device specification or a | 

| device and file name specification. If you use the /SI:n | 

| switch, a file name must be present. | 

| PMissing open parenthesis I 

| You did not specify an open parenthesis [ ( ] when one was | 

| expected. | 

| %More than 16 speeds specified for <terminal> | 

| While processing the TERSPD.SYS file, a terminal was found | 

| that had more than 16 speeds specified. Only the first 16 | 

| speeds are used. | 
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| 7M0UNT privilege is required I 

| You attempted an operation that requires MOUNT privilege. | 

| For example, a user without MOUNT privilege can mount only | 

| private disks. I 

! 7M0UNT privilege required to dismount a public disk I 

| A user without MOUNT privilege tried to dismount a disk | 

| initialized as public. A user without MOUNT privilege can j 

| dismount only private disks. | 

| ?MOUNT privilege required to rebuild a disk | 

j This message occurs when a user without MOUNT privilege j 

I attempts to rebuild a private disk with the /REBUILD | 

| qualifier of the MOUNT command. Have your system manager | 

| rebuild the disk. I 

| PName or account now exists I 

| You attempted either to COPY to or RENAME an existing file. j 

| This error can occur with RENAME if you do not specify | 

| /REPLACE and the output file already exists. It can also | 

j occur with COPY if you specify /NOREPLACE and the output j 

| file already exists. I 

| PNetwork node names must be the same j 

| Different node names were specified on input file I 

| specifications. I 

| ?No buffer space available I 

| The system is overloaded and cannot complete your command | 

| because small buffers are currently unavailable. Try the | 

| command again later. I 

| ?No channels available I 

j An I/O or DCL command file channel is not available. You may j 

j have issued the at (@) command or an OPEN command, but a j 

I channel is not available. I 
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| ?No default { Print , Batch} queue | 

| You did not specify a queue name with the PRINT or SUBMIT j 

| command, and no default queue exists. | 

| ?No default print queue for log file | 

| The /LOG_QUEUE qualifier in a SUBMIT command was specified | 

| without an explicit queue name; however, no default print | 

| queue exists. Use an explicit queue name for the log file. | 

| ?No file name or type permitted | 

| A device :ppn syntax was expected and you supplied a full | 

| file specification which included either a file name or | 

I type . | 

| ?No logins | 

j This message can be displayed when you try to log in, for | 

| one of two reasons: j 

j o The system is full, so it cannot, accept additional | 

| users. | 

j o The system manager has disabled logins. | 

| (Possibly, logins are disabled because the system will be | 

| shut down shortly. ) | 

| ?Non-executable file | 

| This error occurs if the file you are trying to run is a | 

| source file; for example, .BAS. You need to compile and link | 

| the file before you run it. (Note that an executable file | 

| includes the value 64 in its protection code.) | 

| ?Non -printable character j 

| You typed a control character. | 
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| ??Non-res run- time system | 

| This message generally indicates hardware problems. For | 

| example, the run-time system referenced has not been loaded | 

| into memory and cannot be loaded for some reason, and is | 

| therefore nonresident. I 

| %No owner rights to { print , batch} entry <entry-spec> | 

| The entry shown is not your own and you do not have | 

| sufficient privilege to delete it or modify it. | 

| ?N0 prefix not allowed I 

| You used the /NO prefix improperly. | 

| %No { Print , Batch} entry <entry-spec> found | 

| No entries matching the entry-spec you specified in a SHOW | 

| ENTRY or SET ENTRY command were found. | 

| %No { Print , Batch} queue <queue-name> found | 

| No queues matching the queue name you specified in a SHOW | 

| QUEUE or SET QUEUE command were found. I 

| %No { Print , Batch} server <server -name> found I 

| No servers matching the server name you specified in a SHOW | 

| SERVER or SET SERVER command were found. | 

| ?No qualifiers allowed I 

| The user specified a qualifier on a command that does not | 

| allow qualifiers. I 

I %No qualifiers are valid for RESTORE | 

| You attempted to enter a qualifier to the RESTORE mount | 

| qualifier. No qualifiers are valid. I 
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Message and Meaning 



+ 



+ 



?No { read, write , or read/write} access to file <file-spec> [by 
owne r ] 

The file specifications in a PRINT or SUBMIT command' 
requires access that you or the specified owner does not 
have . 



?No room for user on device 

In attempting to create a file on a device, or write 
information to a device, you exceeded some size limit. If it 
was a nondisk device, this error indicates that the device 
was full. If it was a disk device, this error indicates one 
of three conditions: 



o You attempted to create a contiguous file, and there is 
not enough space on the disk. (However, the /CONTIGUOUS 
qualifier for the commands COPY and CREATE produce only 
a warning if there is not enough contiguous space.) 

If you attempted to create a contiguous file but were 
unable to, try to create a noncontiguous file of the 
same size. If you are able to create a noncontiguous 
file then you can conclude the problem is lack of 
contiguous space. 

o If you have eliminated the first two conditions, then 
the disk directory has reached its capacity. This 
capacity is independent of your disk quota. The number 
varies, depending on the directory cluster size that 
the system manager assigned when creating the directory 
and the sizes of the files in it. Large files fill up a 
directory faster than small files, especially if the 
large files have small cluster sizes. Also, if the 
directory itself has a large cluster size, it can hold 
more files and larger files. 



This error can occur if the program you are trying to run 
requires a run-time system that is not installed. 



o 



The disk as a whole is full. 



j ?No run- time system 
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| ?Not a valid device | 

| The device name that you gave is invalid for any of the | 

| following reasons: j 

! o It is not assigned as a system-wide or user logical | 

I name . j 

I | 

| o It is not a physical device name of any device that is j 

| installed on your system. j 

| o The device name is valid, but not with this command. | 

| For example, "INITIALIZE TT:" (you cannot initialize a j 

| te rminal ) . | 

i ?Not enough available memory | 

! An attempt was made to load a executable program that is too | 

| large to run, given the job's private maximum memory size. | 

| Either the program must be allowed to expand above a private j 

| maximum memory size, or the system manager must increase the | 

| job's private memory size maximum to accommodate the | 

| program. I 

| ?Not enough free memory to create dynamic region I 

| There is not enough memory on the system to create a dynamic | 

| region of sufficient size for the operation. If this is a | 

| BACKUP, reducing the BLOCKSIZE parameter may correct the | 

| problem. I 

| ?Number not in range <low> or <high> I 

j You typed a number where one is allowed, but the number is | 

j not in the valid range. The valid range is from <low> to I 

j <high>. I 

| ?Number too big I 

| You typed a number where one is allowed, but the number is | 

| too large. Refer to the command description to find out the | 

| largest acceptable value. I 
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| ?Number too small | 

| You typed a number where one is allowed, but the number is | 

| too small. Refer to the command description to find out the | 

| smallest acceptable value. | 

j ?Pack-id labels don't match | 

| The identification code for the specified disk pack does not | 

| match the identification code already on the pack. This j 

| message can occur when you try to mount or dismount a disk. | 

| ?Page limit exceeds queue's maximum | 

| You specified a /PAGE__LIMIT value in a PRINT command larger | 

| than the maximum allowed for the queue. | 

| ?Parameter or argument too long | 

| This message occurs if a file specification, text string, or | 

| qualifier argument exceeds 255 characters. . j 

I %Please answer "YES" or "NO" | 

| Valid responses to the given prompt are YES and NO only. j 

| %Please specify only a device name j 

| You specified something other than a device name when only a j 

| device name was valid. | 

| ?PPN does not exist I 

| The pro ject -programmer number (PPN) you specified as part of j 

| the job specification does not exist. | 

| ?PPN needed | 

| The command you typed requires that a PPN be specified. | 

j Previous logical name assignment replaced | 

| An informational message to indicate that an ASSIGN command j 

| redefined a previously defined user logical. | 
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+ + 

| Message and Meaning | 
+ + 

{ Print , Batch} entry <entry-number> <entry-spec> created 

Acknowledgment message to PRINT or SUBMIT command. 

{ Print , Batch} entry <entry-spec> - <error text> 

For SET ENTRY , indicates that an entry was not modified for 
the reason stated in the error text. 

?Print/Batch Services already started 

You issued the START/QUEUE/MANAGER command; however, the 
Print/Batch Services (PBS) package is already started. 

?Print/Batch services not running 

You issued a command that requires action by PBS; however, 
the package is not running. 

{ Print , Batch} queue <queue-name> assigned to server <server -name) 

Acknowledgment message for ASSIGN/QUEUE command. 

{ Print , Batch} queue <queue-name> deassigned from server 
<server -name> 

Acknowledgment message for DEAS SIGN/QUEUE command. 

{ Print , Batch} queue <queue-name> closed 

Acknowledgment message for CLOSE/QUEUE command. 

{ Print , Batch} queue <queue-name> deleted 

Acknowledgment message for DELETE/QUEUE command. 

%{ Print , Batch} queue <queue-name> - <error text> 

For SET QUEUE, indicates that a queue was not modified for 
the reason stated in the error text. 

{Print , Batch} queue <queue-name> marked for deletion 

Acknowledgment message for DELETE/QUEUE command when the 
queue you specified still has entries on it. The queue is 
deleted as soon as it becomes empty. 
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- + 

Message and Meaning | 

+ 



{ Print , Batch} queue <queue-name> opened 

Acknowledgment message for OPEN/QUEUE command. 
{ Print , Batch} queue <queue-name> started 

Acknowledgment message for START/QUEUE command. 
{Print , Batch} queue <queue-name> stopped 

Acknowledgment message for STOP/QUEUE command. 
{ Print , Batch} server <server -name> {deleted, marked for deletion 

Acknowledgment message for DELETE/SERVER command. 

%{ Print , Batch} server <server -name) - <error text> 

For SET SERVER, indicates that a server was not modified for 
the reason stated in the error text. 

{Print , Batch} server <server -name> initialized [ non- ] shareable 
[with forms <form-name>] 



Acknowledgment 


message 


for 


INITIALIZE/SERVER command. 


{Print ,Batch} server 


<server 


-name 


> modified 


Acknowledgment 


message 


for 


SET SERVER command. 


{Print ,Batch} server 


<server 


-name 


> started 


Acknowledgment 


message 


for 


START/SERVER command. 


{ Print , Batch} server 


<server 


-name 


> stopped 


Acknowledgment 


message 


for 


STOP/SERVER command. 


Print/Batch Services 


started 


at < 


time> 


Acknowledgment 


message 


when 


you issue the 



START/QUEUE/MANAGER command to begin Print/Batch Services. 



D-38 



General RSTS/E Messages 



Table D-l: General RSTS/E Messages (Cont.) 



+ 



+ 



Message and Meaning 



+ 



+ 



Print/Batch Services stopped at <time> 

Acknowledgment message for STOP/QUEUE/MANAGER command if no 
jobs are being processed. 

Print/Batch Services will stop after { completing , aborting} <n> 



Acknowledgment message for STOP/QUEUE/MANAGER command if any 
jobs are currently in progress. 

?Priority exceeds queue's maximum 

You specified a priority for a PRINT or SUBMIT entry larger 
than the maximum allowed for the queue. 

?<privilege> privilege required 

You typed a command that requires some privilege, and you do 
not have it. 

??Program failure in <program-name> 

This message reports a problem in the software. It is 
followed on the next line by an explanation of the problem. 
You should verify that the failing program is correctly 
installed. If necessary, you should then submit an SPR. The 
SPR should show the dialogue that preceded the message, the 
exact text of the message, and a list of patches that have 
been installed in the failing program. 

PProgram PBS$:PBS.TSK does not exist 

The Print/Batch Services (PBS) program was not found when 
you issued the START/QUEUE/MANAGER command. 

?Protection violation 

This error can occur for reasons similar to the following: 



job[ s] 



o 



You typed a CCL command that your system manager has 
protected against general use. 



o 



You tried to run a program to which you do not have 
execute access. 
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+ + 

| Message and Meaning | 

+ + 

| o You tried to read a file to which you do not have read | 

| access. | 

| o You tried to write to or delete a file to which you do | 

| not have write access. | 

| If this message occurs because of a protection violation | 

| with one of your own files, you can use the SET PROTECTION | 

| command to change the file's protection code. (However, this | 

| error can also occur because of other conditions.) | 

| %Public disk mounted as private | 

| A user with MOUNT privilege mounted a disk initialized as | 

| public without specifying /PRIVATE, /PUBLIC, /SHARE, or | 

| /NOSHARE. The system mounts the disk as private. | 

| ?Qualifier conflicts with file type | 

| You specified the /APPEND qualifier and the file has RMS | 

| attributes. | 

| ?Qualifier conflicts with parameter | 

| You typed a parameter and a qualifier that should not be | 

| present together. For example, with the DEASSIGN command, | 

| you specified the /ALL qualifier and a logical name. | 

| ?Queue already assigned to server | 

| You issued an ASSIGN/QUEUE for a queue already assigned to | 

| the server you specified. Use the SHOW QUEUE/FULL command to | 

| see which servers are assigned to a queue. | 

| ?Queue does not exist | 

| You specified the name of a queue that does not exist. | 

| ?Queue is { closed , deleted} | 

| A PRINT or SUBMIT command entry could not be created on a | 

| queue because the queue is closed or marked for deletion. | 

| Use a different queue. | 
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+ + 

| Message and Meaning I 

+ + 

| ?Queue is privileged | 

| The queue you specified in a PRINT or SUBMIT command j 

| requires one or more privileges that you do not have. Use j 

| the SHOW QUEUE/FULL command to display the privileges that | 

| the queue requires. | 

I ?Queue manager message queue full | 

| There is no room for additional messages to be sent to PBS | 

| at this time. Reissue the request. | 

! ?Quoted string expected | 

| A quoted string or character was expected and was either | 

| missing or was not enclosed in quotes. | 

| %Record too long, line truncated | 

| The record on a READ command was too long. The assignment | 

| occurred; however, only the first 255 characters were | 

| processed. | 

| ?Reserved symbol name | 

| The user attempted to define a local or global symbol which | 

| began with a reserved prefix of $, F$ or f$, or delete a j 

! reserved global symbol from the symbol table that began with | 

| the dollar sign ($). I 

| ?Backup set does not contain a valid ANSI label I 

| The Backup set to restore is not a valid ANSI tape. | 

| %Backup set volume label is not <volume - name) I 

| The Backup set volume name does not match the volume name | 

| specified by the user. I 

| PServer already exists I 

| You issued the INITIALIZE/SERVER command to define a server | 

| that already exists. I 
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+ + 

| Message and Meaning | 

+ + 

I ?Server does not exist | 

| You specified the name of a print or batch server that does | 

| not exist. Use the SHOW SERVER command to list the defined | 

| servers. | 

| PSingle character expected | 

i A single character inside quotes was expected and more than | 

| one character was supplied (for example, SET | 

| DATA/END_OF_DATA ="$$"). | 

| ?Some file data in file <filename> may be missing | 

| The Backup set did not contain the number of file blocks | 

| which it was supposed to contain. If there were other | 

| errors, then this indicates that the file is missing data. | 

! If there are no other errors, submit a SPR with a copy of | 

| the Backup set. | 

| PSource device must be the same | 

| Two different source devices were specified for the | 

| operation. | 

| ?Speed is not allowed for <terminal> I 

| The speed specified is not one of the speeds allowed for | 

| this terminal in the TERSPD.SYS file. I 

| ??Stack overflow | 

| This message indicates a system problem. The system manager | 

| should send in an SPR, giving the dialogue that preceded the | 

| message, the text of the message, and a list of patches that | 

| have been installed. I 

| ?String too long I 

| While in an expression, a string became too long to fit in | 

| the 255 available bytes. I 
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h + 

| Message and Meaning I 

f + 

| ?Substitution too complex I 

| The user's request for apostrophe substitution was rejected | 

| because the substitution was too complex (it reached the | 

| maximum number of substitution iterations allowed on one | 

i command) . I 

| ?Summary record not first record of Backup set I 

| This problem indicates that the Backup set was not written | 

| correctly. Submit a SPR including a copy of the Backup set. | 

| PSymbol name conflicts with < symbol - name> I 

| The user specified an assignment whose symbol name or | 

| abbreviation point conflicted with an existing symbol | 

| definition in the same symbol table. I 

| ?Symbol name too long I 

| The symbol name specified by the user exceeded 255 | 

| characters. I 

| %Symbol table almost full I 

| This warning is issued when your local or global symbol | 

| table has less than 100 free bytes. I 

| ??Symbol table full I 

! You attempted to define a label or symbol when the local or | 

| global symbol table was already full. Note that if you are | 

| in a command procedure when your symbol table gets full, the | 

| command procedure aborts. I 

| ?Syntax error I 

| The command has improper syntax. This occurs when there is | 

| not a more specific message describing the syntax error. | 

| 7THEN clause required I 

| The action clause was missing on the IF <expression> THEN | 

| command or on the ON <severity- level> THEN command. I 
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+ + 

| Message and Meaning | 

+ - - + 

| ?THEN keyword required j 

| The THEN keyword was missing on the IF <expression> THEN j 

| command or on the ON <sever i ty- level> THEN command. j 

| ?This is not the correct output volume | 

! The volume ID of the mounted output volume does not match j 

| the volume name specified in the /OUT_LABEL qualifier. j 

| ?Time limit exceeds queue's maximum j 

| You specified a /TIME__LIMIT value in a SUBMIT command larger | 

| than the maximum allowed for the queue. j 

| ?Too many arguments j 

| You used the notation /qualif ier=( arg,arg, . . . ) with a j 

| qualifier that accepts only a single argument. | 

| ?Too many elements in list j 

| In a list of file specifications or other items (separated j 

| by commas or plus signs), you indicated more file | 

| specifications than are allowed. For example, you exceeded j 

| one of the following limits: | 

| o The DIBOL, RENAME, DELETE, and SET PROTECTION commands | 

| allow six file specifications. j 

| o The COPY command allows six input file specifications j 

| and one output file specification. | 

| o The PRINT and SUBMIT commands allow up to 11 file j 

| specifications. j 

| ?Too many files or parameters | 

| You specified too many file specifications in a PRINT or | 

| SUBMIT command, or a parameter string in a SUBMIT command is j 

| too long to be handled by PBS. Reduce the number of file j 

| specifications or use a shorter parameter string. j 
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+ + 

| Message and Meaning | 

+ - - - - + 

| ?Too many logical names assigned | 

| With the ASSIGN command, you exceeded the maximum number of | 

| logical names. You can only assign up to four logical names | 

| (only three logical names if any of the logical assignments | 

| includes a PPN) . | 

| ?Too many open files on unit I 

| You specified the same magnetic tape or DECtape drive both | 

| as input and output files on COPY or APPEND. | 

| ?Too many parameters I 

| This message occurs if you specify more command parameters | 

| than the command can accept. For example, you specified more | 

| than eight parameters with the /PARAMETERS qualifier. | 

| ?Too many printers initialized | 

| The device you specified could not be initialized because | 

| the maximum number of spooling devices has already been | 

| initialized. | 

| ?Unable to copy tape command file to disk I 

| The user specified an indirect command file on magnetic | 

| tape, and some error occurred when attempting to copy it to | 

| a temporary disk file for processing. I 

| ??Unable to create DCL work file I 

| DCL's work file for storing the user's symbol tables could | 

| not be created on disk. The user may be over quota. I 

| Corrective action should be taken before the user continues | 

| processing. I 

I ??Unable to read DCL work file I 

| The user's symbol tables could not be read in from the DCL | 

| work file. If RSTS/E is processing an indirect command file, | 

| then control immediately returns to the interactive level. j 
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+ + 

| Message and Meaning | 

+ + 

| ?Unable to recover part of Backup set I 

| This message indicates that BACKUP was unable to recover | 

! part of the Backup set, after trying to use error recovery | 

i data. There will also be other messages indicating what data | 

I (if any) was detected to be missing. | 

| ?Unable to start Print/Batch Services I 

| <error message> | 

| Some external condition, as the error message on the second | 

| line describes, prevented PBS from being started. | 

| ??Unable to write DCL work file I 

| The user's symbol tables could not be written out to the DCL | 

| work file. The user may be over quota. Corrective action | 

| should be taken before the user continues processing. If | 

| RSTS/E is processing an indirect command file, then control | 

| immediately returns to the interactive level. I 

| ?Unbalanced parentheses I 

| Parentheses do not match up (for example, A=((5)+6). | 

| ?Undefined label <label> I 

| The label specified on the GOTO command does not exist in | 

| the indirect command procedure being executed. I 

| ?Undefined symbol I 

| The symbol name specified is not defined in the global or | 

| local symbol tables. I 

| PUnexpected character I 

! A character was encountered in a qualifier or a parameter | 

| that was not expected. For example, in SET | 

j TERMINAL/WIDTH=8 OFOO , the "F" of "F00" would be an | 

I unexpected character. I 
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+• : + 

| Message and Meaning | 

■h + 

| ?Unexpected error verifying file data for file <filename> | 

I The RSTS/E monitor reported an error in response to BACKUP'S | 

| request to verify data. Another message describing the | 

| problem follows this message. | 

| ?Unexpected error writing to output file <filename> | 

| The RSTS/E monitor reported an error when writing to the | 

| specified file. Another message describing the problem | 

| follows this message. | 

| ?Unit number required | 

| This message occurs when you specify a device-name without a | 

| device -number (for example, DM: instead of DM0:). | 

| ?Unsupported record structure level - record skipped | 

j This message indicates that the version number of a record | 

| was higher than the highest version known to BACKUP. If this | 

| error occurs trying to restore a Backup set written by a | 

| newer version of BACKUP on an older version of BACKUP, the | 

I operation may not work properly. If the version of BACKUP j 

| writing the tape is older or the same as the one doing the | 

j RESTORE, submit an SPR with a copy of the Backup set that | 

| generated the error. | 

| ?User macros nested too deep | 

| There were more than 50 nested user macros or a user macro | 

| called itself. I 

| %Valid qualifiers are /INITIALIZE and /NOINITIALIZE | 

j You entered a qualifier other than /INITIALIZE and j 

j /NOINITIALIZE and those were the only valid qualifiers. j 

j ?Verif ication failure for directory information for file | 

j <filename> I 

j There was a difference between the directory information | 

| (file size, file flags, etc) stored on the Backup set and in | 

| the directory structure. I 
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+ + 

| Message and Meaning | 

+ - + 

| ?Verif ication failure for file attributes for file <filename> | 

| There was a difference between the file attributes stored on j 

| the Backup set and in the directory structure. | 

| ?Verif ication failure for file data for file <filename> I 

| The file data stored on the Backup set is different from the | 

| file data stored on disk. | 

| %Volume has not been initialized | 

| The initialization request failed, so the output device is | 

| not in an initialized state. BACKUP reprompts for an input j 

i device. | 

| ?Wildcard entry name not allowed | 

| The command you specified does not allow wildcard entry | 

| names. Specify the name of a single entry instead. | 

| ?Wildcards not allowed j 

| You included a wildcard in a file specification, where | 

| wildcards are not allowed. | 

j PWildcard PPN not allowed j 

| The command you specified does not allow wildcard PPNs. | 

| Specify the name of a single PPN instead. j 

| ?Wildcard queue name not allowed | 

| The command you specified does not allow wildcard queue j 

| names. Specify the name of a single queue instead. j 

| %XOR block missing from Backup set | 

| If this error occurs without any other messages, submit an | 

| SPR with a copy of the Backup set. If there are other | 

| messages, this has probably occurred because a block of the | 

| Backup set was unreadable. | 
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+ - - + 

| Message and Meaning | 

%XOR verification failed - group may be unreliable 

This message indicates that BACKUP, during a verify 
operation, concluded that the recovery data for a group of 
data blocks does not match the data found in the blocks. If 
this was not accompanied by other messages, submit a SPR. If 
it was, consider the data in the Backup set to be 
unreliable . 
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SAVE/RESTORE System Program 



The RSTS/E SAVE/RESTORE system program is a disk backup and copy 
utility that has four operational functions: 

o SAVE backs up a disk to tape or disk. 

o RESTORE recreates a disk from tape or disk. 

o IMAGE makes a copy of a disk. 

o IDENTIFY extracts label information from a SAVE/RESTORE 
volume or RSTS/E disk. 



When to Use SAVE/RESTORE 

SAVE/RESTORE and BACKUP perform similar system functions but differ in 
their objectives. SAVE/RESTORE provides a nonselective, fast-volume 
restore and copy capability that requires few operator responses 
during the operational dialogue. Unlike BACKUP, SAVE/RESTORE 
processes entire volumes only and does not allow selective file 
transfers. When SAVE/RESTORE finds bad blocks, it requires no 
operator intervention. For these reasons, use the SAVE/RESTORE 
program when you need to: 

o Create a fast, reliable copy of an entire RSTS/E disk 

o Make a fast copy to a disk containing bad blocks that may not 
be reflected in the BADB.SYS file 

o Make a recovery medium (bootable) for a system disk in case 
of catastrophic errors 
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Definitions of SAVE/RESTORE Terms 

To understand this appendix, you should know these terms: 

o SAVE format: The format of the output written by a SAVE 
operation and read by a RESTORE operation. 

o SAVE Set: The set of magnetic tapes or disks created by a 
SAVE operation. A SAVE Set must be composed entirely of 
disks or tapes; it cannot be a combination of the two device 
types. However, you can mix different drive types within one 
set, for example, two RK05's and one RK06. 

o SAVE volume: One of the magnetic tapes or disks of a SAVE 
Set . 

o SAVE Set Name: One- to six - alphanumeric characters used to 
identify a SAVE set. By default, the SAVE set name is the 
same as the Pack ID from which it was created. However, you 
can specify another name for the SAVE Set. 

o LIKE Disks: Like disks are units of the same device size 
(that is, the same number of data blocks). SAVE/RESTORE 
considers the following devices alike: 

Two RP06 disks 

- An RM02 and an RM03 

- An RP04 and an RP05 

- An RK05 (RK05J) and one unit of an RK05F 

Therefore, if you copied an RM02 to a SAVE Set, the SAVE Set 
can later be restored either to an RM03 or another RM02. 



Running SAVE/RESTORE 

You use the SAVE/RESTORE program off line while running the system 
initialization code INIT.SYS. In reply to the INIT OPTION prompt, 
type SAVRES. SAVE/RESTORE asks for the current date and time and then 
responds with the SAV/RES FUNCTION prompt. For example: 

Option: SAVRES 

DD-MMM-YY? 14 -MAY- 85 
HH : MM? 12:15 

SAV/RES Function: 
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Note 

You must run SAVE/RESTORE off line to copy (SAVE or 
IMAGE) or restore (RESTORE) the system disk with 
which you are currently running on line. 

You can also use SAVE/RESTORE on line, during timesharing. When you 
do, you must not logically mount the RSTS/E disk(s) on which 
SAVE/RESTORE operates. This ensures the integrity of the data on the 
disk(s). To run SAVE/RESTORE on line, type RUN $SAVRES. SAVE/RESTORE 
then prints its program prompt: 

$ RUN $SAVRES<RET> 
SAV/RES Function: 

After the SAV/RES FUNCTION prompt appears, as a result of running 
SAVE/RESTORE either off line or on line, you are under the control of 
SAVE/RESTORE and are ready for restore processing. 

Next, select from Table E-l one of the four operational functions: 
o SA[VE] 
O RE [STORE] 
o IM [ AGE ] 
O ID [ ENTI FY ] 

Unless you need to exit SAVE/RESTORE (by pressing LINE FEED, or 
entering CTRL/Z ) or need further help (by typing HE [ LP ] or pressing 
the RETURN key), type one of the four functions on your terminal in 
response to the SAV/RES FUNCTION prompt. For example: 

SAV/RES Function: RESTORE<RET> 

This starts the SAVE/RESTORE program, which immediately prints the 
first of several dialogue questions. The section "SAVE/RESTORE 
Dialogue" contains sample dialogues for each of the operational 
functions . 

Table E-l lists the possible responses to the SAVE/RESTORE prompt. 
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Table E-l: SAVE/RESTORE Functions 



+ + 

J Function | 
+ + 



Description 



SA[VE] 

RE [ STORE] 

IM[ AGE ] 
ID[ ENTIFY] 

HE [ LP ] 
LF 



RET 

CTRL/C 
CTRL/Z 
other 



Creates a copy of a RSTS/E file - structured disk. The 
SAVE function backs up to disk or tape. 

Recreates a RSTS/E file - structured disk from a SAVE 
Set. 

Copies a RSTS/E file - structured disk to a like disk. 

Prints label information and other volume 
characteristics of a SAVE volume or a RSTS/E 
f ile - st ructured disk. 

Prints a table of SAVE/RESTORE functions. 

Exits the SAVE/RESTORE program. If you run 
SAVE/RESTORE with a RUN command, pressing LINE FEED 
returns you to your keyboard monitor. If you are 
running SAVE/RESTORE off line with INIT.SYS, pressing 
LINE FEED returns you to the INIT OPTION prompt. 

Displays the "Type HELP for help" message on your 
terminal . 

Produces the same result as pressing the LINE FEED 
key . 

Produces the same result as pressing the LINE FEED 
key. 

Produces the same result as pressing the RETURN key. 



+ 



Your response to the SAV/RES FUNCTION prompt determines the type of 
dialogue SAVE/RESTORE performs. You can respond to the prompt in 
several ways: 



o With the function name, such as SAVE or RESTORE, or by 

pressing a key such as RETURN, as shown in Table E-l. If you 
enter only a function, the full dialogue follows. See the 
section "SAVE/RESTORE Dialogue." 

o With the function name and various switches. For example: 

SAV/RES Function: SAVE/EXP : 10 -MAY - 86 

If you include switches with the function, the dialogue 
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questions follow only for the devices to be used and the 
unspecified switches. See the following section. 

o With a full function command line. For example: 

SAV/RES Function: IMAGE DM1 : =DM0 : MYPAK/VER/NOERR 

If you enter a complete command line, SAVE/RESTORE does not 
ask any dialogue questions. See the section "Full Function 
Command Line." 

SAVE/RESTORE prints messages on your terminal to tell you its status. 
Some messages are for information only; other messages are error 
conditions that may require your attention during the dialogue, mount, 
transfer, or verification phases of SAVE/RESTORE. 

When the program finds an error during a dialogue or mount operation, 
it asks you to correct the problem and to retype the appropriate 
command. Such errors never affect the integrity of the data being 
transferred . 

However, errors that occur while SAVE/RESTORE is transferring or 
verifying data can jeopardize data. In this case, SAVE/RESTORE 
resolves the problem, aborts the run, or asks you whether to continue 
or to abort the program. The program gives you information to help 
you protect your data by printing informational messages and error 
messages on your terminal. 

Finally, SAVE/RESTORE prints an optional summary report about SAVE, 
RESTORE, or IMAGE operations at the end of the run. This report 
describes : 

o The operation performed 

o Device information 

o Start date and time statistics 

o Run total statistics, which includes the number of errors 
found during the operation. 



SAVE/RESTORE Switches 

You can include SAVE/RESTORE switches in a function response or in a 
full function command line. There are two types of switches: 

o The expiration and verification switches correspond to 
questions in the SAVE/RESTORE dialogue and have default 
settings. If you do not include the switches in a function 
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response, the dialogue asks you for that information. For 
example, if you do not include the /EXPIRATION switch, the 
dialogue asks: 

Expiration Date<DD-MMM- YY>? 

If you include one of the switches in a function response, 
SAVE/RESTORE does not ask the corresponding question but does 
ask the question for the switch you did not specify. For 
example, if you include the /EXPIRATION switch but not 
/VERIFY, SAVE/RESTORE does not prompt you for an expiration 
date but does ask the verification question. 

If you do not include the switches in the full function 
command line, SAVE/RESTORE assumes the default settings. For 
example, if you do not include the /VERIFY switch, 
SAVE/RESTORE assumes /NOVERI FY . This means if you do not 
explicitly include the /VERIFY switch in a full function 
command line, SAVE/RESTORE does not compare the data 
transfer . 

o The /STATS and /ERROR switches have no corresponding dialogue 
questions but do have default settings. Therefore, if you do 
not specify these switches in a function response or command 
line, SAVE/RESTORE assumes the default settings. 

Table E-2 lists the allowable SAVE/RESTORE switches 



Table E-2: SAVE/RESTORE Switches 



Switch 



Default and Description 



EX[ PIRATION] [ :date] 
NOEX [ PI RAT I ON ] 



EXPIRATION 

SAVRES warns you of any attempt to overwrite 
the volume(s) any time before the specified 
date. The date argument is the date after 
which you may overwrite the destination 
volume. You can use this switch only for a 
SAVE operation. 

If you specify /EX[ PIRATION ] with no date 
argument, SAVRES uses one year after the 
current date as the the expiration date. 

If you specify /NOEX [ PIRATION] , SAVRES uses 
the current date as the expiration date. 
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Table E-2; SAVE/RESTORE Switches (Cont.) 



Switch | Default and Description 



VE [ RIFY ] 


| 

| NOVERIFY 


NOVE [ RIFY ] 


| You can use this switch only for a SAVE, 




| RESTORE, or IMAGE operation. If you specify 




| the /VE[ RIFY ] switch, SAVRES compares the 




1 voiuiue ( s j to iuaKe sure tnat tne transrer was 




| accurate. 


ST[ATS ] 


| 

| STATS 


NOST[ATS] 


| SAVRES does not automatically print a 




| summary report at the end of a run, unless 




| you specify the /ST[ATS] switch with either 




| a function response or a full function 




| command line. See the section "SAVRES 




| Summary Report." 


ER[ ROR ] 


j ERROR 


NOER [ ROR ] 


| If you do not include the /ERROR switch and 




| a nonfatal error occurs during a SAVRES run, 




| SAVRES prints an error message and continues 




| processing. This is the default condition. 




| You must specify explicitly the /NOERROR 




| switch if you want SAVRES to print an error 




| message and terminate as a result of any of 




| the errors described in Table E-12. 



SAVE/RESTORE Dialogue 

The SAVE/RESTORE dialogue begins after you run the SAVE/RESTORE 
program and respond to the SAV/RES FUNCTION prompt. If you type SAVE, 
RESTORE, IMAGE, or IDENTIFY, the program asks a set of dialogue 
questions, which have either a short or a long form. The short form 
appears automatically while the long form prints only if you press the 
RETURN key in response to the short form question. The long form 
gives you information to help you answer the questions. Tables E-5 
through E-8 show the text of each of the long form questions in 
quotation marks ("). 

Some of the questions have default values which the program prints in 
angle brackets. You can select the default value by pressing the LINE 
FEED key or by typing the proper default response. If you press LINE 
FEED in response to a question that has no default, SAVE/RESTORE 
repeats the question. 



E-7 



SAVE/RESTORE System Program 



There are two valid responses to a SAVE/RESTORE program that can 
change its operating status: 

O GTRL/Z 

O CTRL/C 

If you enter CTRL/Z at any point in the dialogue, SAVE/RESTORE returns 
to the previous question. A CTRL/C response aborts the run 
immediately and returns you to the INIT OPTION prompt if you are 
running off line under the control of the INIT. SYS program, or to your 
keyboard monitor prompt if you are running SAVE/RESTORE on line. 
SAVE/RESTORE automatically returns to the SAV/RES FUNCTION prompt 
after the execution of a specified function when you are operating 
either on line or off line. Exit from the INIT version of 
SAVE/RESTORE to the OPTION prompt by pressing LINE FEED. Type CTRL/Z 
to the SAV/RES FUNCTION prompt to exit the online version of 
SAVE/RESTORE. 



SAVE Volumes 

You can perform SAVE/RESTORE operations on disks and tapes. The SAVE 
Set, a set of tapes or disks created from a SAVE operation, cannot 
include both disks and tapes. However, the SAVE Set can include one 
or more volumes of the same class. In other words, a tape volume SAVE 
Set could consist of two MM devices and one MT device or one RP04 and 
two RK05 disks. 

A legal SAVE disk device is any disk supported by RSTS/E that meets 
the following requirements: 

o All disks must be formatted; that is, contain sector and 
track information. 

o All disks used by the online version of SAVE/RESTORE must 
have a valid RSTS/E file structure; that is, the disk device 
must be formatted by DSKINT prior to its use. The one 
exception to this rule is the disk you have used as a SAVE 
Set volume. It does not have the RSTS/E file structure (and 
cannot be logically mounted) but can be used for SAVE/RESTORE 
operations. 

o The first 16 blocks plus the device cluster size blocks on a 
disk must not contain any bad blocks. 

o A RSTS/E output disk can contain no more than 161 bad 
clusters (the RSTS/E limit). 
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Magnetic tape is the only valid SAVE/RESTORE tape medium; DECtape and 
cassette are unacceptable. The following statements define what 
constitutes a valid tape in the SAVE/RESTORE package: 

o The magnetic tape must be long enough to contain: 

The SAVE Set label and header information 

A bootstrap 

INIT.SYS that is on the first volume only 

Two copies of the RSTS/E disk file SATT.SYS 

At least 16 blocks of data from the RSTS/E disk 



o A bad block is considered to be the end-of-tape (EOT) volume 
during the SAVE operation. 

o The default density is the lowest density allowed by the 
drive on which the first volume is mounted. Later volumes 
cannot be written at any other density. You must make sure 
the density used on the first volume is compatible with all 
other tape drives you plan to use. 



Device Specifications 

SAVE/RESTORE requires you to use device specifications as responses to 
several dialogue questions. The general format is: 

<device> [ : [ <id> ] ] [ <switch( es ) > ] 

Device is a two- character device type (for example DU) followed by a 
single-digit unit number in the range to 7 . The identification can 
be either a SAVE Set Name or a disk pack identification; the switches 
are any of those from Table E-3. 
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Table E-3: SAVE /RE STORE Device Specification Switches 



Switch 



Description 



/SCR[ATCH] 



/DEN[SITY]:[ 800] 
[ 1600 ] 



The /SCRATCH switch is legal only on an output 
volume device specification. If you use the 
/SCRATCH switch, SAVRES by-passes most volume 
label checking. The program always checks the 
label to see if an output volume contains a 
SAVE Set written at the current density and 
make sure that it is not a volume from the 
SAVE Set currently being written. It also 
checks destination disks for bad block 
information . 

The /DENSITY switch is legal only for magnetic 
tape. With this switch, you can specify the 
density at which the tape is to be written or 
read. If SAVRES cannot read the tape at the 
specified density, it tries to read the tape 
at the other legal density setting. 



+ 



Privileges Required 

You need RDNFS, WRTNFS, and SYSMOD privileges to gain read/write 

non - f ile - st ructured access to a disk. If a device is restricted, you 

also need DEVICE privilege to gain access to that device. 



Checking the Input Volume 

SAVE/RESTORE checks the input volume before transferring any actual 
data and warns you of any problem it foresees in saving, restoring, or 
copying the volume. All of the input volume error messages that are 
printed at this point are warning messages only; you can recover from 
them by following appropriate procedures. 

Table E-4 lists and describes the error messages that result from a 
problem with an input volume. 
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Table E-4: SAVE/RESTORE Input Volume Error Messages 

+ - + 

| Message and Meaning | 
+ + 

%%% Input disk has only nn% free clusters. 
Mount it anyway <NO>? 

The input disk has very few clusters that are not allocated. 
There must be at least as many good pack clusters on an 
output RSTS/E disk as there are clusters to be transferred 
from the original input disk. This message indicates that 
you may encounter problems copying or restoring the disk. 

Type NO or press RETURN to return to the previous device 
prompt. If you type YES, SAVRES proceeds with the SAVE or 
IMAGE operation. The program also checks the output volume 
to see if the transfer can be made (see the section 
"Checking the Output Volume"). At this point, you may want 
to free up space on the input disk by deleting unnecessary 
files. This increases your chances of eventually completing 
a successful RESTORE. 

%%% This is not the correct volume. 

The pack ID or SAVE Set Name you included with the input 
device specification does not match the name already written 
on the volume. If SAVRES finds that the names do not match, 
it prints the warning message and then issues the input 
device prompt again. A dismount request follows the warning 
message and lists useful information from the volume label 
of a SAVE Set or a RSTS/E file - structured disk. 

%%% This volume has no label. 

The input volume is not a RSTS/E disk or a SAVE Set. SAVRES 
prints the input device prompt again after issuing the 
warning message. 

%%% Input disk should be rebuilt. 

You removed a disk from a drive without logically 
dismounting it and then attempted to remount it. Perform the 
clean operation with the ONLCLN program or the REFRESH 
option of INIT.SYS. See the RSTS/E System Installation and 
Update Guide for information on REFRESH. See the RSTS/E 
Utilities Reference Manual for information on ONLCLN. 
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Checking the Output Volume 

SAVE/RESTORE checks the output volume before restoring or copying a 
RSTS/E disk to make sure that each operation ends with the least 
chance of error. After checking the output volume, SAVE/RESTORE 
displays messages about the expiration date, the label, and the 
available data space on the destination device. Some of the messages 
are only for your information; the rest warn you of serious output 
device problems. 

When the expiration date of an output volume, labeled as a SAVE Set, 
has passed, SAVE/RESTORE prints this series of messages and proceeds 
to the next dialogue question: 

*** The volume on dev: is SAVE Set <xxxxxx> 
Density : nnn 

Creation date : day-of-week, dd-mmm-yy 
Expiration date : day-of-week, dd-mmm-yy 

If you decide not to use the expired date volume, enter CTRL/Z to 
return to the TO DEVICE output question. 

If the output volume is labeled as a SAVE Set and its expiration date 
has not passed, SAVE/RESTORE prints this series of messages: 

*** The volume on dev: is SAVE Set <xxxxxx> 
Density : nnn 

Creation date : day-of-week, dd-mmm-yy 

Expiration date: day-of-week, dd-mmm-yy 
%%% Its expiration date has not passed 
Mount it anyway <N0>? 

If you type NO or press LINE FEED to the mount question, SAVE/RESTORE 
returns to the previous device prompt. SAVE/RESTORE goes to the next 
question if you type YES. If you press RETURN, SAVE/RESTORE prints: 

*** This is your last chance to prevent the 
*** loss of any data on the output volume. 
Mount it anyway <N0>? 

When the output volume you are using is labeled a RSTS/E disk, 
SAVE/RESTORE prints the message: 

*** The volume on dev: is a RSTS disk 
*** Pack ID is <xxxxxx> 
*** Pack will be reinitialized 
Mount it anyway <N0>? 

If you type NO or press LINE FEED, SAVE/RESTORE returns to the 
previous output prompt. A YES response indicates you want to use the 
present volume. 
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If you restore (RESTORE) or copy (IMAGE) a disk, SAVE/RESTORE checks 
whether the total number of clusters on the output disk minus the 
known bad blocks is greater than or equal to the number of allocated 
clusters on the original source disk. If there is not enough space 
and the transfer cannot be made, it prints the following message and 
then returns to the previous device prompt: 

%%% Too many bad blocks on output disk. 

However, if the program decides there are very few free blocks, it 
prints : 

%%% Only nn% of the output disk clusters are available for 

relocation. 

Mount it anyway <N0>? 

You must decide whether the number of free clusters is large enough to 
permit a successful SAVE/RESTORE operation. If you decide it is not, 
type NO or press LINE FEED to return to the output prompt. Type YES 
if you want SAVE/RESTORE to continue the operation. 

Note 

Whenever you get this warning message, DIGITAL 
recommends you use another disk for output. If you 
do not, there is a greater than normal chance the 
operation will not succeed. 

SAVE/RESTORE normally transfers each allocated pack cluster from the 
original source disk to the same cluster on the output RSTS/E disk. 
If SAVE/RESTORE finds the output cluster is bad, it tries to relocate 
the data. If the cluster size of the item being moved is larger than 
the pack cluster size, there must be enough contiguous free pack 
clusters on the output disk to accommodate the entire source cluster. 
If there is not, SAVE/RESTORE aborts the operation. 

If the specified output is not a RSTS/E disk, the program prints the 
new SAVE Set Name and proceeds without further notice. It does not 
check the output volume label if you specified the /SCRATCH switch, 
except to determine whether it is a volume of the SAVE Set that is 
currently being created. It always attempts to recover bad block 
information from a RSTS/E file - structured and SAVE disk. 
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Saving a RSTS/E Disk using the SAVE Dialogue 

The SAVE function backs up an entire RSTS/E- formatted disk to either 
tape or disk. The output volumes created by this operation are 
collectively called the SAVE Set and are written by SAVE/RESTORE in 
the SAVE format. You can recreate the original disk only by using the 
RESTORE operation. You cannot use other RSTS/E software, such as 
BACKUP or PIP.SAV to restore a SAVE Set. Note that you must use SAVE 
if the output medium is different from the input medium. 

Once you determine that the disk you are to save and the output SAVE 
Set device(s) are valid media, type SAVE to start the SAVE dialogue 
described in Table E-5. 

Note 

When SAVE/RESTORE creates a SAVE Set, it includes an 
extra set of directory blocks on the output volume in 
case some directory blocks are found to be bad during 
a RESTORE operation. These additional blocks are 
reflected in the total block count for a SAVE Summary 
Report. Because the extra blocks are needed only 
when bad blocks are found during a RESTORE operation, 
it is unnecessary for SAVE/RESTORE to transfer these 
blocks to the restored volume. 

Thus, you will notice a discrepancy between the 
number of blocks transferred for a SAVE operation and 
the number transferred during a RESTORE. 
Furthermore, because the extra directory blocks are 
not transferred to the restored volume, under certain 
circumstances you may restore your data to one less 
volume than existed in the SAVE Set. 

The Pack ID of the input disk is the default SAVE Set Name of the 
output volumes. After you answer the From RSTS Disk? question, 
SAVE/RESTORE tells you the output SAVE Set Name it intends to use. 
The general format is: 

*** Pack ID/default SAVE Set Name is <xxxxxx> 

If you do not want the output volume(s) to have this SAVE Set Name, 
specify a different Pack ID in the <devspec> response to the To 
Device? question. After you select the ID and answer the question, 
SAVE/RESTORE prints: 

*** SAVE Set Name is <xxxxxx> 

SAVE/RESTORE warns you if the output volume contains a SAVE Set that 
has an expiration date that has not passed. You can proceed or 
respecify the output volume (see "Checking the Output Volume"). 
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Table E-5 lists the SAVE dialogue questions. An example of a 
SAVE/RESTORE procedure follows the dialogue description. 



Table E-5: SAVE Dialogue Questions 



+ 



+ 



+ 



Question 



Response and Description 



+ 



+ 



+ 



From RSTS Disk? 



<devspec> 



Data is transferred from the specified 
disk. If you include a Pack ID in the 
device specification, SAVE/RESTORE 
checks whether it matches the one on the 
disk. When it does not, the program 
prints a warning message (see section 
"Checking the Input Volume") and prints 
the From RSTS Disk? question again. 

Type 2 characters to specify the input 
device type, followed by a single digit 
(0-7) to specify the unit number. 
Include a Pack ID if you want 
SAVE/RESTORE to make sure it matches the 
one on the volume. The disk must be 
physically (but not logically) mounted 
and should ie write - locked . 



All data is transferred from the 
previously specified input disk to this 
tape or disk. If you do not specify a 
SAVE Set Name in the <devspec>, 
SAVE/RESTORE gives the SAVE Set the same 
name as the input disk. 

Type 2 characters to specify the output 
device type, followed by a single digit 
(0-7) to specify the unit number. 
Include a SAVE Set Name if you want to 
override the default. This drive should 
have a SCRATCH volume mounted, and must 
be write - enabled . 



To Device? 



<devspec> 
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Table E-5: SAVE Dialogue Questions (Cont.) 



Question 



Response and Description 



Expiration Date 
<DD-MMM- YY>? 



Verify (Yes or No 
<N0>? 



Proceed (Yes or No)? 



<DD-MMM-YY> 

This is the dialogue form of the 
/EXPIRATION switch (see section 
"SAVE/RESTORE Switches"). If you do not 
specify a date, SAVE/RESTORE creates an 
expiration date for the SAVE Set that is 
one year from the date that it was 
created . 

Type the desired expiration date or 
press the LINE FEED key to accept the 
date printed. 

Y[ES] or N[0] 

This is the dialogue form of the /VERIFY 
switch (see section "SAVE/RESTORE 
Switches"). If you type YES, the output 
is then compared to the input at the end 
of each volume of the SAVE Set. 

Type YES if you want SAVE/RESTORE to 
compare the input and output volumes at 
the end of each output volume. Type NO 
or press LINE FEED if you do not want 
SAVRES to perform this verification. 

Y[ES] or N[0] 

This question lets you either double 
check your dialogue responses, and abort 
the operation if you have made any 
errors, or proceed with the SAVE 
operation . 

Type YES to proceed with the operation. 
Type NO to abort and return to the 
SAV/RES Function: prompt. 



The following SAVE example shows the backup of an RM03 disk to tape. 
The letters are keyed to the explanation that follows this sample. 
The SAVE steps are: 

1. Physically mount the RM03 source disk on drive DR1 : , 
write - locked . 
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2. Physically mount the destination tape on drive MMl : , 
write - enabled. 

3. Type RUN $SAVRES and then press RETURN. 



a RUN $SAVRES<RET> 

b SAV/RES Function: SA<RET> 

c From RSTS disk? DRl : <RET> 

*** Pack ID/default SAVE Set Name is JOEM 
d TO Device? MMl : SAVSET<RET> 

*** SAVE Set Name is SAVSET 
e Expiration Date <10-May-85>? 10 -May- 86<RET> 
f Verify (Yes or No) <NO>? <RET> 
g Proceed (Yes or No)? Y<RET> 

*** Initializing first SAVE volume 

*** Begin SAVE from DRl: to MMl: at 08:07 PM 

h Dismount Device: MMl: 

Set Name: SAVSET 

Seq #: 1 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

Please label this volume 

Mount volume # 2 of SAVE Set SAVSET 
i Device ? MM2<RET> 

j Proceed (Yes or No)? y<RET> 

*** Begin SAVE from DRl: to MM2 : at 08:14 PM 

Dismount Device: MM2: 

Set Name: SAVSET 

Seq #: 2 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

Please label this volume 
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--- SAVE operation completed at 08:22 PM 

k Summary Report 

SAVE of DRlrJOEM to SAVE Set SAVSET 

Input Device: DR1 : 

Pack ID: JOEM 

Pack Clustersize: 8 

Creation date: Saturday, 6-Apr-85 

Output Device: Magtape 

Set Name: SAVSET 

# of volumes: 2 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

SAVE started on Tuesday, 10-May-85, at 08:07 PM 

1 Run Statistics 

Transfer Totals: 

Total of 55192 blocks transferred 

Error Totals: 

Total of new bad blocks encountered on source. 

Timing Totals: 

Total elapsed time: hrs., 14 mins., 41 sees. 

Total wait time: hrs., mins., 19 sees. 

Total process time: hrs., 14 mins., 22 sees, 
m SAV/RES Function: <CTRL/Z> 
$ 

The explanation of the SAVE example follows: 

a Type RUN $SAVRES, then press RETURN to run the SAVE/RESTORE 

program. 

b After you press RETURN, SAVE/RESTORE prints its initial program 

prompt. Because you need to perform a backup operation of an 
RM03, you select the SAVE function of SAVE/RESTORE by typing SA 
and pressing RETURN. 

c SAVE/RESTORE asks for the device name and unit number of the 
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disk from which you are extracting data. You respond with DRl : , 
indicating unit 1 of the RM03 disk. 

As an option, you could have included a Pack ID with the device 
specification. If you had, SAVE/RESTORE would have compared 
your Pack ID response to the ID currently on the disk. By not 
specifying a Pack ID, SAVE/RESTORE accepts the current ID. 

After you terminate your response to this question by pressing 
RETURN, the program shows you the name of the SAVE Set. 

d You specify the medium to which SAVE copies the input data. 

Because you want the SAVE Set to reside on tape, you type MMl : . 
Rather than allow SAVE to give the SAVE Set the same name as the 
input disk, you give the SAVE Set its own. If you assign the 
input and output media separate names, you can better 
differentiate their identity (with IDENTIFY) at a future date. 
Once you end your response, SAVE stores the name you specified 
on the output medium and then prints the SAVE SET NAME IS SAVSET 
message . 

e SAVE creates a default expiration date equal to the current date 

plus one year. This represents the date after which you can 
write over the data. Rather than accept the default by pressing 
LINE FEED, you specify your own date and press RETURN. 

f You choose not to have SAVE/RESTORE verify the transfer. A YES 

or Y response causes SAVE to perform a verify pass after it 
completes the data transfer process. In the verify pass, SAVE 
compares the input data with the data it transfers to the output 
medium. As an alternative, if you know that you need to verify 
the transferred data, you can attach the /VERIFY switch to the 
SAVE/RESTORE function and thus suppress the VERIFY (YES or NO) 
question . 

g You have made no errors in the dialogue sequence; therefore, you 

can type Y to have SAVE proceed with the operation. Because no 
default exists for this question, you must type either a YES or 
a NO response. Once you terminate your answer, SAVE notifies 
you that it is initializing the first SAVE volume. Only the 
first volume of the SAVE Set is initialized. When that 
operation is complete, SAVE prints a message indicating that the 
transfer process has begun, which devices are involved, and the 
time the operation began. 

h The dismount report summarizes the label information found on 

the initial SAVE Set volume. If SAVE/RESTORE requires another 
volume, it asks you to mount the next volume in the SAVE Set 
after the first volume is exhausted. 

i You respond to the DEVICE question with the device name and unit 

number of the second SAVE Set volume, then press RETURN. 
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j Again, you have the option to proceed or to abort the operation. 

Because there is no reason to abort, you type Y and press RETURN 
to proceed. SAVE then notifies you, as it did for the first 
volume, that the SAVE operation has begun, that the data is 
being transferred, and that 08:14 was the time the SAVE 
operation began. As soon as SAVE finishes the transfer, it 
issues the dismount message for the second volume of the SAVE 
Set, informs you that the SAVE operation is complete, and the 
time it finished. 

k The SAVE Summary Report appears by default and can only be 

suppressed by attaching the /NO STATS switch (or by making 
/NOSTATS the default) to a SAVE/RESTORE function. The report 
includes the Pack ID and SAVE Set names, label information for 
both the input and output volumes, and the date of the SAVE 
operation . 

1 The Run Statistics Report prints the number of blocks 

transferred, the number of bad blocks encountered, and elapsed 
times. Note that the blocks transferred includes an extra set 
of directory blocks stored at the end of the SAVE Set. The 
additional set of directory blocks are included to make sure 
that SAVE/RESTORE has a valid directory to read when it attempts 
to restore from the SAVE Set. 

m When the SAVE operation is complete, SAVE/RESTORE returns to its 

initial SAV/RES FUNCTION prompt. If you want to return to your 
keyboard monitor prompt (DCL in this example), enter CTRL/Z. 



Restoring a RSTS/E Disk using the RESTORE Dialogue 

To recreate a RSTS/E file - structured disk from a SAVE Set, you must 
perform the RESTORE operation. Because SAVE/RESTORE writes the SAVE 
Set in the SAVE format, no other RSTS/E software can perform this 
rebuild process. Before transferring any data, SAVE/RESTORE tries to 
extract bad block information from the destination disk and, if it 
finds any bad blocks, incorporates them into the new BADB.SYS file. 

The SAVE/RESTORE program may find bad blocks during a RESTORE run. If 
it does, it scans the SATT.SYS file to determine if there is a place 
where the block corresponding to a bad block can be relocated. If a 
large enough area exists on the destination disk, the program simply 
moves the data to the new location and modifies the directory 
information accordingly. 

The relocation of blocks may require RESTORE to change a file's 
characteristics. For example, this can occur if the program finds a 
bad cluster while transferring a contiguous file. To relocate the 
cluster that falls on the bad block, SAVE/RESTORE must make the file 

./ 
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noncontiguous. Changes of this type can cause problems, but RESTORE 
preserves the data and informs you of these adjustments. 

The operation ends if there is no way RESTORE can relocate the data 
cluster. This can occur if: 

o No unallocated pack cluster remains on the disk 

o The file cluster size is larger than the pack cluster size 
and there is not an equivalent number of contiguous pack 
clusters left on the disk 

Normally, SAVE/RESTORE uses the name of the input SAVE Set as the Pack 
ID of the output volume. After you answer the From Device? question, 
SAVE/RESTORE prints a message showing you the name it plans to use. 
The general format is: 

*** SAVE Set name/Default Pack ID is xxxxxx 

After you successfully respond to the TO RSTS DISK question, 
SAVE/RESTORE prints the message: 

*** Pack ID is xxxxxx 

Table E-6 lists the RESTORE dialogue questions. An example of a 
RESTORE procedure follows the dialogue description. 



Table E-6: RESTORE Dialogue Questions 



Question 



Response and Description 



From Device? 



<devspec> 

Data is transferred from the specified 
device. If you include a SAVE Set Name in 
the device specification (see section 
"Device Specifications"), SAVE/RESTORE 
checks whether it matches the name on the 
device. If it does not, the program 
prints a warning message (see section 
"Checking the Input Volume") and prints 
the From Device? question again. 

Type 2 characters to specify the input 
device type, followed by a single digit 
(0-7) to specify the unit number. Include 
a SAVE Set Name if you want SAVE/RESTORE 
to make sure it matches the one on the 
volume. The device must be physically 
mounted and write - locked. 
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Table E-6: RESTORE Dialogue Questions (Cont.) 



Question 



Response and Description 



To RSTS Dx: Disk? 



Verify(Yes or No)<NO>? 



Proceed(Yes or No)? 



specification, it 
the restored disk 
SAVE/RESTORE uses 



<devspec> 

Data from the previously specified SAVE 
Set is restored to this disk. If you 
include a Pack ID in the device 

becomes the Pack ID of 

Otherwise, 
the SAVE Set Name 
(which may also be the Pack ID of the 
original source disk). Physically mount 
and write-enable the disk. 

Type 2 characters to specify the output 
device type, followed by a single digit 
(0-7) to specify the unit number. Include 
a Pack ID if you want to override the 
default. This drive should have a SCRATCH 
volume mounted, and must be 
write-enabled. 

Y[ES] or N[0] 

This is the dialogue form of the /VERIFY 
switch. If you type YES, SAVE/RESTORE 
compares the output with the input at the 
end of each input volume to make sure the 
volumes are equivalent. 

Type YES if you want SAVRES to compare 
the input and output volumes at the end 
of each input volume. Type NO or press 
LINE FEED if you do not want SAVRES to 
perform this verification. 

Y[ES] or N[0] 

This question lets you either double 
check your dialogue responses and abort 
the operation if you have made errors, or 
proceed with the RESTORE operation. 

Type YES to proceed with the operation. 
Type NO to abort and return to the 
SAV/RES Function: prompt. 



E-22 



SAVE/RESTORE System Program 



Note 

If you are using the output of a RESTORE operation as 
a system disk, you must use the INIT.SYS INSTALL 
option to reinstall the desired monitor Save Image 
Library (SIL). You must also reenter any necessary 
HARDWR suboptions (such as changing Hertz) because 
the INSTALL option clears various items set up by the 
HARDWR suboptions. This procedure is necessary 
because a disk can be saved with SAVE from one system 
disk and restored with RESTORE on a system with a 
different hardware configuration. 

The following RESTORE example shows the restoration of an RM03 disk 
from the tape SAVE Set created in the previous example. The letters 
are keyed to the explanation that follows this sample. 

The RESTORE steps are: 

1. Mount the two SAVE Set volumes on drive MMl : and MM2 : , 
write -protected . 

2. Mount the destination disk on DRl:, write-enabled. 

3. Type RUN $SAVRES and press RETURN. 



a $ RUN $SAVRES<RET> 

b SAV/RES Function: RESTORE < RET > 

c From device? MMl : <RET> 

*** SAVE Set Name/default Pack ID is SAVSET 

d TO RSTS DR: Disk? DRl : TSTPAK<RET> 

*** The volume on DRl: is a RSTS disk 
*** Pack ID is MYPAK 

*** Pack will be reinitialized 
Mount it anyway <NO>? Y<RET> 

*** Pack ID is TSTPAK 

e Verify (Yes or No) <NO>? <RET> 
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Proceed (Yes or No)? Y<RET> 

*** Begin RESTORE from MMl : to DR1 : at 08:28 PM 

Dismount Device: MMl: 

Set Name: SAVSET 

Seq #: 1 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

Mount volume # 2 of SAVE Set SAVSET 
Device ? MM2:<RET> 

Proceed (Yes or No)? y<RET> 

*** Begin RESTORE from MM2 : to DRl : at 08:32 PM 

Dismount Device: MM2: 

Set Name: SAVSET 

Seq #: 2 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

Dismount Device: DRl: 

Pack ID: TSTPAK 

Pack Clustersize: 8 

Creation date: Monday, 15-Apr-85 

Please label this volume! 

RESTORE operation completed at 08:37 PM 

Summary Report 

RESTORE of SAVE Set SAVSET to DRl: TSTPAK 

Input Device: Magtape 

Set Name: SAVSET 

# of volumes: 2 

Density: 800 

Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

Output Device: DRl: 

Pack ID: TSTPAK 

Pack Clustersize: 8 

Creation date: Monday, 15-Apr-85 

RESTORE started on Friday, 10-May-85, at 08:28 PM 
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h Run Statistics 

Transfer Totals: 

Total of 54184 blocks transferred 
Error Totals: 

Total of new bad blocks encountered on destination. 

files structurally altered. 
Timing Totals: 

Total elapsed time: hrs., 9 mins., 36 sees. 

Total wait time: hrs., mins., 16 sees. 

Total process time: hrs., 9 mins., 20 sees, 
i SAV/RES Function: <CTRL/Z> 
$ 

The explanation of the RESTORE example follows: 

a Type RUN $SAVRES, and then press RETURN to run the SAVE/RESTORE 

program. 

b Begin the RESTORE operation by typing RESTORE and pressing 

RETURN in response to the initial SAVE/RESTORE prompt. Because 
you need to recreate an RM03 from a tape SAVE Set, you select 
the RESTORE function. 

c The RESTORE dialogue begins when it prints the From Device? 

question. In response, you specify the device name and the unit 
number of the SAVE Set medium and press RETURN. Because the 
input medium is tape, mounted on drive number 1, you enter MMl : . 
If you had included a SAVE Set Name in the device specification, 
RESTORE would have checked it against the name already on the 
set. If they had not matched, RESTORE would have issued a 
warning message informing you of the discrepancy. After you 
terminate your response by pressing RETURN, RESTORE reads the 
SAVE Set Name from the input medium and displays it on your 
terminal . 

d Because in this RESTORE operation you are recreating an RM03 

disk, you respond to the To RSTS DR: Disk? question by typing 
DRl : TSTPAK . By your response, you indicate that the device 
mnemonic of the RM03 is DR, that it is mounted on drive number 
1, and that you want it to have a Pack ID of TSTPAK. After 
pressing RETURN, RESTORE checks the Pack ID of the output disk. 
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It then prints a message showing you that the disk is a RSTS/E 
disk, has a Pack ID of MYPAK, and that RESTORE will reinitialize 
it. RESTORE issues a Mount It Anyway? question that gives you 
the option to mount the disk or not. Because the data on the 
disk is no longer valuable, answer Y and press RETURN. RESTORE 
then initializes the disk with the new -Pack ID. 

e The comparison of the input data to the data already transferred 

to the destination disk is not essential during this particular 
run; therefore, you press RETURN to accept the No default. When 
you ask RESTORE to verify the transferred data, you are 
essentially requesting that RESTORE perform two operations 
rather than one. That is, you make the program perform two 
passes on the data, once for the transfer and once for the 
comparison. 

f No mistakes were made during the dialogue phase; therefore, 

RESTORE proceeds with the operation in reply to your Y response. 
After you press RETURN, RESTORE displays a message to indicate 
it has begun the transfer. After RESTORE completes the first 
volume, it prints input medium information, asks you to mount 
the next volume, and asks if you want to continue the operation. 
Again, because there are no errors in the dialogue, RESTORE 
proceeds. RESTORE moves the remaining data to the second 
volume, issues the input and output dismount messages, and 
informs you that the operation is completed. 

g The Summary Report prints the SAVE Set Name, the Pack ID, and 

label information for both the input and output medium, in 
addition to the date and time of the RESTORE operation. 

h The Run Statistics Report prints the number of blocks 

transferred, the number of bad blocks encountered, and the times 
required to perform various operations. 

i RESTORE returns to the SAV/RES FUNCTION prompt when the 

operation has ended. Enter CTRL/Z to return to your default 
keyboard monitor (DCL in this example). 



Copying a RSTS/E Disk using the IMAGE Dialogue 

The IMAGE function lets you make an equivalent copy of a RSTS/E 
file - structured disk; however, only disk- to-LIKE-disk transfers are 
legal when using the IMAGE operation. LIKE disks are units that have 
exactly the same device size. The SAVE/RESTORE program handles bad 
block recovery during an IMAGE operation in the same way as RESTORE. 

Table E-7 lists the IMAGE dialogue questions. An example of the IMAGE 
operation follows the dialogue description. 
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Note 



If you are using the output of an IMAGE operation as 
a system disk, you must use the INIT.SYS INSTALL 
option to reinstall the desired monitor Save Image 
Library (SIL). You must also reenter any necessary 
HARDWR suboptions (such as changing Hertz) because 
the INSTALL option clears various items set up by the 
HARDWR suboptions. This procedure is necessary 
because you can make a copy of a disk on one system 
and use the copied disk on another. 



Table E-7: IMAGE Dialogue Questions 



+ 



+ 



+ 



Question 



Response and Description 



+ 



+ 



+ 



From RSTS Disk? 



<devspec> 



SAVE/RESTORE transfers all data from the 
disk specified in the device 
specification response. If you include a 
Pack ID in the device specification, 
SAVE/RESTORE checks to see if it matches 
the one actually on the disk. If it does 
not, the program prints a warning message 
(see section "Checking the Input Volume") 
and prints the From RSTS Disk? question 
again . 

Type 2 characters to specify the input 
device type, followed by a single digit 
(0-7) to specify the unit number. Include 
a Pack ID if you want SAVE/RESTORE to 
make sure it matches the one on the 
volume. This device must be physically 
mounted and write-locked. 



SAVE/RESTORE transfers all information 
from the previously specified source disk 
to this disk. If you include a Pack ID in 
the device specification, it becomes the 
Pack ID of the output disk. Otherwise, 
SAVE/RESTORE uses the Pack ID of the 
source disk. 



To RSTS Dx: Disk? 



<devspec> 
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Table E-7: IMAGE Dialogue Questions (Cont.) 



Question 



Response and Description 



To RSTS Dx: Disk? 
( Cont . ) 



Verify(Yes or No)<NO>? 



Proceed(Yes or No)? 



Type 2 characters to specify the output 
device type, followed by a single digit 
(0-7) to specify the unit number. Include 
a Pack ID if you want to override the 
default. This drive should have a SCRATCH 
volume mounted, and must be 
write -enabled . 

Note that the device mnemonic you specify 
in response to the From RSTS Disk? 
question appears in place of the Dx in 
the To RSTS Dx: Disk? question. In some 
cases, in your device specification 
response to the To RSTS Dx: Disk? 
question, you may specify a device 
mnemonic other than the one that appeared 
for Dx. See the discussion of LIKE disks 
in the section "Definitions of 
SAVE/RESTORE Terms . " 

Y[es] or N[o] 

This is the dialogue form of the VER[ I FY ] 
switch. If you type YES, SAVE/RESTORE 
compares the output with the input at the 
end of each output volume to ensure that 
the volumes are equivalent. If you type 
NO, SAVE/RESTORE moves on to the next 
question without performing a verify 
pass. 

Type YES if you want SAVE/RESTORE to 
compare the input and output volumes at 
the end of the IMAGE copy operation. Type 
NO or press LINE FEED if you do not want 
SAVE/RESTORE to perform the verification. 

Y[ES] or N[0] 

This question lets you either double 
check your dialogue responses and abort 
the operation if you have made any errors 
or proceed with the IMAGE operation. 

Type YES to proceed with the operation. 
Type NO to abort and return to the 
SAV/RES Function: prompt. 
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After you answer the From RSTS Disk? question, the program prints a 
message in the following general format to tell you the Pack ID it 
intends to use: 

*** Input Pack ID/default Output Pack ID is XXXXXX 

If you do not want the output disk to have the same name as the input 
volume, specify a different Pack ID in the <devspec> response to the 
To RSTS DX: Disk? question. After you select the Pack ID and answer 
the question, SAVE/RESTORE prints: 

*** Output Pack ID is XXXXXX 

The following procedure describes an IMAGE operation that copies an 
RA80 to an RA80 and verifies the transfer in the same pass. The 
letters are keyed to the explanation that follows this sample. 

The IMAGE function steps are: 

1. Mount the source disk on drive DUO:, write - locked. 

2. Mount the destination disk on drive DUl : , write -enabled. 

3. Type RUN $SAVRES and press RETURN. 

a $ RUN $SAVRES<RET> 

b SAV/RES Function: I MAGE/NOERROR< RET > 
c From RSTS disk? DU0:<RET> 

*** Input Pack ID/default Output Pack ID is SOURCE 
d To RSTS DU: Disk? DUl : DESTIN<RET> 



*** The volume on DUl: is a RSTS disk 
*** Pack ID is OUTPUT 



*** Pack will be reinitialized 
Mount it anyway <N0>? YES<RET> 

*** Output Pack ID is DESTIN 

e Verify (Yes or No) <N0>? YES<RET> 

f Proceed (Yes or No)? YES<RET> 



*** Begin IMAGE copy from DUO: to DUl: at 11:02 AM 
*** Begin VERIFY pass from DUO: to DUl: at 11:04 AM 
*** differences found 
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Dismount Device: DUl: 

Pack ID: DESTIN. 

Pack Clustersize: 8 

Creation date: Friday, 10-May-85 

Please label this volume! 

--- IMAGE copy operation completed at 11:07 AM 

g Summary Report 

IMAGE copy of DUO: SOURCE to DUl: DESTIN 

Input Device: DUO: 

Pack ID: SOURCE 

Pack Clustersize: 8 

Creation date: Friday, 10-May-85 

Output Device: DUl: 

Pack ID: DESTIN 

Pack Clustersize: 8 

Creation date: Friday, 10-May-85 

IMAGE copy started on Friday, 10-May-85, at 11:02 AM 

h Run Statistics 

Transfer Totals: 

Total of 24400 blocks transferred 

Error Totals: 

Total of bad compares. 

Total of new bad blocks encountered on source. 

Total of new bad blocks encountered on destination 

files structurally altered. 
Timing Totals: 

Total elapsed time: hrs., 5 mins., 22 sees. 

Total wait time: hrs., mins., sees. 

Total process time: hrs., 5 mins., 22 sees, 
i SAV/RES Function: <CTRL/Z> 
$ 



E-30 



SAVE/RESTORE System Program 



The explanation of the IMAGE example follows: 

a Type RUN $SAVRES and press RETURN to run the SAVE/RESTORE 

program. 

b SAVE/RESTORE prints the SAV/RES FUNCTION prompt to determine 

which function you want to perform. To create a copy of an 
RA80, select the IMAGE function by typing IM/NOERROR and 
pressing RETURN. Attach the /NOERROR switch to insure that no 
data is lost. The /NOERROR switch causes SAVE/RESTORE to end 
the operation whenever the program finds a run-time error. 
Before the program aborts, it prints an error message indicating 
the source of the problem. 

c In reply to the From RSTS Disk? question, specify the disk from 

which you are to extract the data. Enter the device name and 
unit number of the input disk and end the response by pressing 
RETURN. After this response, IMAGE reads the Pack ID from the 
input disk and displays it on your terminal. 

d IMAGE requests the device name and unit number of the output 

disk. Type DBl : DESTIN to indicate that the RA80 is on drive 1 
and you want DESTIN to be the new Pack ID. As soon as you press 
RETURN, SAVE/RESTORE tells you that the output medium is a 
RSTS/E disk, its Pack ID is OUTPUT, and it will be initialized. 
SAVE/RESTORE initializes the disk when you type Y and press 
RETURN in response to the Mount it anyway? question. A message 
that SAVE/RESTORE prints informs you that the disk was 
initialized to the specified Pack ID. 

e To insure against losing data, type YES to have IMAGE determine 

if the input data equals the data that was transferred to the 
output disk. If IMAGE finds that the data is not equivalent, it 
informs you of these differences. 

f You are satisfied that you made no errors in the dialogue 

sequence and feel that the operation should proceed. After you 
press RETURN, IMAGE informs you when it begins to transfer data 
and when it begins the verify pass. After completing the data 
comparison, IMAGE prints the number of differences found between 
the two devices. It then issues the output device dismount 
message. Immediately after IMAGE prints the dismount request, 
it prints a message to show you the copy operation ended 
successfully. 

g IMAGE prints the Summary Report unless you suppress it by using 

the /NOSTATS switch. The report includes the Pack ID and label 
information of each disk, in addition to the date and time that 
the IMAGE operation was run. 
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h The Run Statistics Report provides a total figure for the number 

of blocks transferred, the errors encountered, and the times 
required to perform the IMAGE operation. 

i SAVE/RESTORE returns you to the SAV/RES FUNCTION prompt when the 

operation ends. Enter CTRL/Z to return to your keyboard monitor 
(DCL in this example). 



IDENTIFY Dialogue 

If you want label information from a SAVE Set volume or a RSTS/E 
file - structured disk, use the IDENTIFY function. SAVE/RESTORE asks 
only one question before the IDENTIFY operation begins. 

Table E-8 lists the IDENTIFY dialogue question. Examples of the 
IDENTIFY operation appear after the table. 



Table E-8: IDENTIFY Dialogue Question 




Response and Description 



<devspec> 
SAVE/RESTORE 
characterist 
file - structu 
specified in 
you include 
SAVE/RESTORE 
the name on 
the program 
the section 
and then pri 
again . 



prints the device label 
ics of the SAVE Set or RSTS/E 
red disk for the device 

the dialogue response. If 
a SAVE Set Name or Pack ID, 

checks to see if it matches 
the device. If it does not, 
prints a warning message (see 
"Checking the Input Volume") 
nts the From Device? question 



Type 2 characters to specify the input 
device, followed by a single digit (0-7) 
to specify the unit number. Include a 
SAVE Set Name or Pack ID if you want 
SAVE/RESTORE to make sure it matches the 
one on the volume. You must mount and 
write-lock the device (for protection) 
before responding to the From Device? 
question. 
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The following IDENTIFY example shows the label characteristics of both 
a SAVE Set and a RSTS/E disk. The letters are keyed to the 
explanation that follows this sample. 

The IDENTIFY procedures are: 

1. Mount a SAVE Set volume on MM1 : , write -locked. 

2. Mount the RSTS/E disk on drive DRl : , write - locked . 

3. Type RUN $SAVRES and press RETURN. 



a $ RUN $SAVRES<RET> 

b SAV/RES Function: id MMl:<RET> 

c Device: MMl : 

Set Name: SAVSET 
Seq #: 1 
Density: 1600 
Creation date: Friday, 10-May-85 

Expiration date: Saturday, 10-May-86 

d SAV/RES Function: id DRl : <RET> 

Device: DRl: 
Pack ID: TSTPAK 
Pack Clustersize: 8 

Creation date: Monday, 15-Apr-85 

e SAV/RES Function: <CTRL/Z> 

$ 



a Type RUN $SAVRES and press RETURN to run the SAVE/RESTORE 

program. 

b The SAVE/RESTORE program prints the SAV/RES FUNCTION prompt. 

You respond to it with the first two letters of the IDENTIFY 
function and with the device name and unit number of the medium 
you want to identify. Include a Pack ID if you want 
SAVE/RESTORE to compare the ID you specify with the one on the 
input volume. 

c IDENTIFY prints label information for the tape SAVE Set. 

d SAVE/RESTORE returns to the SAV/RES FUNCTION prompt. In 

response, you ask SAVE/RESTORE to identify the disk pack mounted 
on DRl:. SAVE/RESTORE prints the information as soon as you end 
your response. 
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e Enter CTRL/Z to return to your keyboard monitor (DCL in this 

example ) . 



Full Function Command Line 

Use the full function command line format if you do not want to answer 
each dialogue question separately. The general format is: 

SAV/RES Function: <f unction><outdevspec>=< indevspeo [ <switch( es) > ] 

Function can be SA[VE], RE[ STORE], IM[ AGE ] , or ID [ ENTI FY ] and the 
switches can be any of those listed as valid with the associated 
function (see section "SAVE/RESTORE Switches"). See the section 
"Device Specifications" for an explanation of the device 
specifications. 

If you specify a full command in response to the SAV/RES FUNCTION 
prompt, SAVE/RESTORE prints only the PROCEED question (except during 
an IDENTIFY question): 

Proceed (Yes or No)? 

You must type either YES or NO to this question. Type YES to have 
SAVE/RESTORE begin the operation; type NO to abort. 

SAVE/RESTORE does the same standard volume label checking during the 
full function command line operation as it does during the longer 
dialogue procedure. If a discrepancy occurs, SAVE/RESTORE prints the 
error message and then returns to the SAV/RES FUNCTION prompt. At 
that point, you must type the full function command line again. 



SAVE/RESTORE and Booting 

SAVE/RESTORE always attempts to create bootable media. The output of 
a RESTORE or IMAGE copy operation is bootable if the original disk 
contained an INIT.SYS file in [0,1] (even if the original disk was not 
bootable). The first output volume that the SAVE operation produces 
is always bootable because SAVE/RESTORE copies the INIT.SYS file from 
the system disk and HOOKs it on this volume. Note that only the first 
volume in a SAVE Set is bootable. 
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If a SAVE volume is booted, a portion of INIT.SYS is loaded, allowing 
you to perform the following INIT options: 

O SAVE/RESTORE 

O DSKINT 

O BOOT 

o HARDWR option specifying the LIST suboption 

The types of SAVE/RESTORE operations you can perform depend on the 
type of device you boot from. You can run all four SAVE/RESTORE 
options if you boot from a RSTS/E disk. However, you can perform only 
an IDENTIFY, IMAGE, or RESTORE operation if you boot from a RSTS/E 
magnetic tape or SAVE volume. If you boot a SAVE volume and then 
perform a RESTORE operation, SAVE/RESTORE prints a message at 
completion of the run: 

*** Please boot from the system disk 

Boot device? 

You must specify the device name and unit number of a bootable device. 

Table E-9 summarizes the SAVE/RESTORE operations you can perform while 
booting various devices. 



Table E-9: Booting RSTS/E and SAVE Set Volumes 



Device Booted 
From 



SAVE/RESTORE 
Operations You 
Can Perform 



SAVE/RESTORE 
Operations You Can 
Perform Afterwards 



RSTS/E Magnetic 
Tape 

SAVE Set Volume 
(Disk or Tape) 

SAVE Set Volume 
(Disk or Tape) 



RSTS/E Disk 



IDENTIFY, IMAGE, RESTORE | IDENTIFY, IMAGE, RESTORE 



IDENTIFY, IMAGE 



RESTORE 



SAVE , RESTORE , IMAGE , 
IDENTIFY 



IDENTI FY , IMAGE , RESTORE 



None -- You receive a 
message that states you 
must boot from the 
system disk. 

SAVE , RESTORE , IMAGE , 
IDENTIFY 
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Note 

You cannot use the console bootstrap to boot a 
magnetic tape SAVE Set if: 

o The tape has a density of 1600 bpi . 

o The drive the tape is mounted on has a TM02 
formatter. (Use the HARDWR LIST suboption of 
INIT to determine the type of formatters on your 
drives . ) 

However, you can boot a 1600 bpi tape on a drive with 
a TM02 formatter if you use the BOOT OPTION prompt of 
INIT. SYS. That is, you can boot under these 
circumstances using software but not hardware boot 
procedures. As an additional restriction, you can 
boot a magnetic tape SAVE Set only on the following 
drives: TS11, TU45, TU80, TU16, TU77, and TE16. 



Operator Interface During Processing 

SAVE/RESTORE requires operator intervention at certain points during 
processing. The operator must mount and dismount devices, reset hung 
devices, and abort operations when necessary. The following sections 
describe these procedures. 



Mounting and Dismounting Volumes 

A SAVE Set can contain more than a single volume. Because you may be 
processing multivolume SAVE Sets, the SAVE/RESTORE program contains 
procedures that allow you to mount the additional volumes in a set. 
When SAVE/RESTORE needs an additional volume to complete a SAVE or 
RESTORE operation, it prompts you with the message: 

Mount volume #nn of SAVE Set <setnam> 
Device? 



Proceed (Yes or No)? 
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The letters nn represent the volume sequence number and <setnam> 
indicates the SAVE Set Name and unit number of the drive on which the 
next volume has been readied. If you mount a device of the same type, 
you can respond to this prompt only with a unit number. After you 
press RETURN to terminate your device specification, SAVE/RESTORE 
performs volume label checking (see sections "Checking the Input 
Volume" and "Checking the Output Volume"). At this point, if the 
additional volume you mount violates any SAVE/RESTORE rule, the 
program prints the error message immediately after the Device? 
question . 



SAVE/RESTORE prints a dismount message when: 



o SAVE/RESTORE completes a SAVE Set volume during a SAVE or 
RESTORE operation 

o SAVE/RESTORE completes the data transfer to the output volume 
in an IMAGE copy operation 



o You mount an incorrect volume 



Note that the dismount message SAVE/RESTORE generates for a SAVE Set 
(Format 1) differs from a dismount message printed for a RSTS/E disk 
( Format 2 ) : 



Format 1 



Dismount Device: <device> 

Set Name: <setnam> 

Seq # : nn 

Density: [ 800] 

[1600] 

Creation Date: <(day-of -week) , dd-mmm-yy> 

Expiration Date: < ( day- of -week ) , dd-mmm-yy> 



Format 2 



Dismount Device: <device> 

Pack ID: <packid> 

Pack Clustersize: mm 

Creation Date: <(day of week), dd-mmm-yy> 

The <device> field represents, a two character device mnemonic followed 
by a single digit unit number. The SAVE Set Name replaces <setnam>, 
and the disk pack identification replaces <packid> during a valid 
SAVE/RESTORE operation. Density figures are printed only for magnetic 
tape SAVE Sets. Finally, if SAVE/RESTORE has just written to the 
volume, it prints the PLEASE LABEL THIS VOLUME message immediately 
after the dismount message of the volume. 
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Re-Accessing Devices 

During an operation you may find that SAVE/RESTORE does not have 
access to a previously accessible device. If a device does become 
hung or is write -protected, the program notifies you in the warning 
message : 

%%% Device hung or write-locked 
Retry (Yes or No)? 

Correct the condition causing the problem if possible, and then type 
YES to attempt to gain access to the device. Type NO to abort the 
attempt. . 



Aborting SAVE/RESTORE 

To end a SAVE/RESTORE operation at any time, enter CTRL/C. This 
returns control to your keyboard monitor if you running SAVE/RESTORE 
on line. If you are running under the control of the INIT.SYS program 
and the operation ends, INIT.SYS returns you to its OPTION prompt. An 
abort during a SAVE, RESTORE, or IMAGE operation leaves the output 
volume unusable. However, you do not jeopardize any IDENTIFY volumes 
if you choose to abort this operation. 



SAVE/RESTORE Summary Report 

SAVE/RESTORE prints a Summary Report at the end of RESTORE, and IMAGE 
operations. The report identifies the operation that was run, lists 
characteristics of the input and output devices, and generates a list 
of data transfer, error, and timing statistics. It also documents the 
time and date of the operation. 



Summary Report Format and Example 

The format of the Summary Report varies with the operation. At times 
the Input Device characteristics (see Figure E-l) identify a SAVE Set, 
as in the case of a RESTORE operation. Thus, depending on the 
operation, the SAVE Set format may be represented under either the 
input or Output Device category. The RSTS/E disk format may be 
printed also under the Input or Output Device categories. 
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Figure E-l shows the general format of the SAVE/RESTORE Summary 
Report. 



SAVE 

IMAGE of disk<packid> to disk<packid> 

RESTORE SAVE Set <setnam> SAVE Set<setname> 

Input Device: <device> 

Pack ID: <packid> 

Pack Clustersize: nn *RSTS/E disk format 

Creation date: <day of week, dd-mmm-yy> 

[magnetic tape] 
Output Device: [disk] 

Set Name: <setnam> *SAVE Set format 

# of volumes: nn 

Density: [ 800] 

[1600] 

Creation date: <day of week, dd-mmm-yy> 

Expiration date: <day of week, dd-mmm-yy> 

Run Statistics 

Transfer Totals: 

Total of nnnnnnn blocks transferred 
Error Totals: 

Total of nnn bad compares. 

Total of nnn new bad blocks encountered on source. 

Total of nnn new bad blocks on destination disk. 

Total of nnn files structurally altered. 

Timing Totals: 

Total elapsed time: nn hrs., nn mins., nn sees. 
Total wait time: nn hrs., nn mins., nn sees. 
Total process time: nn hrs., nn mins., nn sees. 

Figure E-l: Summary Report Format 
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Summary Report Run Statistics 

Table E-10 lists and describes the run statistics that appear at the 
end of a SAVE, RESTORE or IMAGE operation. Because each SAVE/RESTORE 
operation prints its own set of run statistics, Table E-10 also 
identifies the operations in which each run statistic is printed. The 
operations are identified according to the following conventions: 

S = SAVE operation 

R = RESTORE operation 

I = IMAGE operation 



Table E-10: Summary Report Run Totals 



+ + 

| Type of Statistic | 
+ + 



Operation and Description 



Transfer Statistics 

Total of blocks 
transferred 



Error Statistics 

Total of bad 
compares 

Total of new bad 
block errors 
encountered on 
source 

Total of bad block 
errors on 
destination disk 

Total of files 

structurally 

altered 



This number refers to the total number of 
blocks transferred (directory blocks, file 
blocks). In a SAVE operation an extra set of 
directory blocks is stored at the end of a 
SAVE Set. The total number of blocks 
transferred includes these extra blocks. 
[SRI] 



The total number of errors that occurred 
during the VERIFY phase. [SRI] 

The number of previously unreported bad 
blocks encountered on the source disk. [SRI] 



The number of previously unreported bad 
blocks encountered on the destination disk 
[SRI] 

The number of files that were structurally 
altered to enable relocation on the 
destination disk. (This means contiguous 
files were made noncontiguous or placed 
files were moved.) [RI] 
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Table E-10: Summary Report Run Totals (Cont.) 



Type 


of Statistic 


- + ■ 

1 


Operation and Description 


Time 


Statistics 


- + ■ 




Total 
(TE) 


elapsed time 




The total amount of real clock time that 
elapsed during the run. [SRI] 


Total 
(TW) 


wait time 




The amount of real clock time that elapsed 
while waiting for operator responses and 
magnetic tape rewinds. [SRI] 


Total 

(TP) 


process time 


- + 


The amount of real clock time that was used 
for processing (TE-TW=TP). [SRI] 



SAVE/RESTORE Error Handling 

SAVE/RESTORE issues dialogue, mount, transfer, and verification error 
messages. When you find an error message during a dialogue or a 
mount, SAVE/RESTORE asks you to correct the condition, where 
appropriate, and then asks you to reenter the command. Errors you 
encounter during either of these phases never affect the integrity of 
the data being transferred. 

Note 

When SAVE/RESTORE reports an error during a transfer 
or verification phase, it has detected a problem that 
might corrupt the data being transferred. Depending 
on the nature of the error, a single file, or perhaps 
an entire volume, might be affected. Generally, you 
encounter fewer critical errors during a dialogue or 
mount phase than in a transfer or verification 
operation . 

SAVE/RESTORE does not report an error when it finds a bad block on the 
output device, unless it is unable to reallocate that block in a way 
that is transparent to you. For instance, the one-block file 
SHIFT. LES is moved without notice if a free cluster can be found. On 
the other hand, the program issues an error message if it must move 
the placed file, MOVEME . NOT . 

The /NOERROR switch causes SAVE/RESTORE to abort the run if it finds 
any condition that warrants an error message. If you do not specify 
the /NOERROR switch, the program takes whatever action necessary. 
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SAVE/RESTORE always informs you of any corrective action taken so you 
have the option of aborting the operation. 

The most important problem that SAVE/RESTORE encounters during a 
RESTORE or IMAGE copy operation is finding a bad block on a RSTS/E 
file - structured disk when it wants to write to that block. The 
program attempts to correct the problem by performing the following 
actions in the order listed: 



1. Marks a contiguous file as noncontiguous and relocates the 
bad cluster but not the entire file. 



2. Marks the file as nonplaced if the bad cluster occurs at the 
beginning of a placed file. 

3. Finds enough contiguous free pack clusters on the output disk 
to hold the number of clusters that must be moved. In other 
words, if the cluster size of a file is 16, SAVE/RESTORE 
finds 16 free contiguous blocks for the cluster. It proceeds 
if the reallocation worked and aborts if it has not worked. 



SAVE/RESTORE always tells you about the changes it makes to a file 
that are caused by this bad block processing. If there is no way to 
relocate a cluster, the program aborts the operation. Unless you 
specify the /NOERROR, SAVE/RESTORE never terminates an operation when 
it finds a bad block that results in a nonfatal error (see the section 
"SAVE/RESTORE Switches" ) . 



General SAVE/RESTORE Error Messages 

Table E-ll describes the errors that can occur during SAVE/RESTORE 
operations. 

Table E-ll: General SAVE/RESTORE Error Messages 

+ - + 

I Message and Meaning | 
+ + 

%%% Bad block in first n blocks of output volume 

The current volume is unusable. Sufficient space must be 
available at the beginning of a SAVE Set to store certain 
critical information necessary for a SAVE/RESTORE operation. 

Mount a different volume and try again. 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ - + 

| Message and Meaning | 

+ + 

| ??? Bad block in MFD | 

I SAVE/RESTORE aborts the operation when it finds a bad block j 

I in the Master File Directory (MFD). | 

I %%% Bad block in SATT.SYS | 

| There is a bad block in the input SATT.SYS file. j 

| SAVE/RESTORE does not use an input disk that has a corrupt j 

I SATT.SYS file. | 

| ??? Bad block on magtape - can't continue j 

j SAVE/RESTORE requires a magnetic tape SAVE Set volume to be | 

| long enough to contain a bootstrap, label information, and j 

| INIT.SYS. Whenever the program finds a bad block before it j 

| transfers all required information, it aborts the current j 

j operation. | 



%%% Bad data: 

in [MFD] 

[<[P,PN] FILENAME. TYPE> ] 
[UFD [P,PN] ] 
[GFD, nnn] 



A cluster contained in the described account or file could 
not be relocated due to a fatal read error on the output 
volume . 



??? Bad directory for device 

SAVE/RESTORE discovered a bad link or bad block in the input 
or output directory structure. 



%%% Bad INIT.SYS on system disk 



SAVE/RESTORE found a bad block in INIT.SYS while 
transferring it from the system disk to a SAVE Set volume. 

%%% Can't mix device types in SAVE Set 

A SAVE Set cannot be composed of both tapes and disks. Only 
all disk or all tape SAVE Sets are legal. 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ - + 

| Message and Meaning | 

+ + 

| %%% Can't read bad block file j 

| SAVE/RESTORE could not read the bad block file on a RSTS/E j 

I disk or a SAVE Set volume. j 

| ??? Can't read SAVE Set volume SATT | 

j A nonrecoverable I/O error occurred while SAVE/RESTORE | 

j attempted to read the Storage Allocation table on the SAVE j 

j Set volume. | 

I %%% Can't write boot | 

j The bootstrap could not be written to the first block of the j 

j output disk. j 

| %%% Can't write INIT.SYS | 

j SAVE/RESTORE found a fatal bad block while transferring j 

| INIT.SYS to SAVE Set volume. | 

j %%% Device hung or write-locked j 

j Retry (Yes or No)? j 

j The output device is off line or is write-locked. Correct j 

j the condition and try again. Type YES to continue or type NO j 

j to abort. j 

| %%% Device mnemonic must be specified | 

I Enter the device name along with the unit number. j 

| %%% Disk must be DSKINTed | 

j When you are running SAVE/RESTORE on line, the output disk j 

j must be RSTS/E file - structured or a SAVE Set volume. Use the j 

j DSKINT option of INIT.SYS to reinitialize the disk. See the j 

j RSTS/E System Installation and Update Guide for a | 

j description of the DSKINT option. j 

j %%% Duplicate switches | 

j You specified the same switch more than once. j 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ + 

| Message and Meaning | 
+ - + 

??? Error in BADB.SYS allocation 

SAVE/RESTORE was unable to rebuild the bad block file 
(BADB.SYS) after completing the current operation. 

??? Fatal output bad block 

A bad block was found at a critical position, preventing 
SAVE/RESTORE from completing the current operation. 

%%% Illegal command 

Your response to a prompt was in an unacceptable format. 

%%% Illegal command: 
no output device specified 

The full function line command you specified did not include 
an output device specification. 

%%% Illegal date 

The date you specified was in an unacceptable format or was 
included where none was acceptable. 

%%% Illegal density 

The density you specified was in an unacceptable format, was 
included where none was acceptable, or specified an illegal 
density value. 

%%% Illegal option 

When booting from a SAVE Set volume, you can use only the 
RESTORE, IMAGE, and IDENTIFY options. 

%%% Illegal switch 

You used a switch in an unacceptable way. 

%%% Illegal switch combination 

You specified conflicting switches. 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ + 

| Message and Meaning | 
+ + 

%%%#Input disk has only nn% free clusters. 
Mount it anyway <No>? 

SAVE/RESTORE discovers the input disk has very few clusters 
that are not allocated and may find problems copying or 
restoring the disk. You may want to delete some unnecessary 
file to increase the chances that SAVE/RESTORE can 
eventually complete a successful RESTORE. 

%%% Input disk should be rebuilt 



The disk you mounted is "dirty." The SATT.SYS file may be 
corrupt. SAVE/RESTORE requires a valid SATT.SYS; therefore, 
rebuild the disk using the REFRESH option of INIT or the 
ONLCLN program. See the RSTS/E System Installation and 
Update Guide for a description of REFRESH. See the RSTS/E 
Utilities Reference Manual for information about ONLCLN. 



%%% Its expiration date has not passed 
Mount it anyway (Yes or No)? 

A SAVE Set on an output volume contains an expiration date 
that has not expired. SAVE/RESTORE prints the SAVE Set Name 
and expiration date before issuing this message. 

Confirm whether you should use this volume or mount a 
different volume if appropriate. 

%%% Magtape select error 
Retry (Yes or No)? 

When access to a magnetic tape drive was attempted the 
selected unit was off line. 

%%% No default-type <cr> for more information 

You typed a LINE FEED in response to a question which has no 
default. 

??? No INIT. SYS on system disk 

There is no INIT. SYS in account [0,1] on the system disk. 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ - - + 

| Message and Meaning | 
+ + 

%%% No previous question - type <cr> for more information 

You attempted to return to the previous question but it no 
longer exists. 

%%% Non-existent or hung device 

You specified a disk or magnetic tape that does not exist on 
your system or is not on line. 

Check your configuration or the device type again and retry. 

??? Non- recoverable I/O error 

SAVE/RESTORE found a fatal error condition while trying to 
recover from a DEVICE HUNG OR WRITE LOCK error. SAVE/RESTORE 
aborts the current operation and returns you to the SAV/RES 
FUNCTION prompt. 

%%% Not a valid device 

You specified an unacceptable device type in response to the 
question. This may occur if you specify: 

o A device other than magnetic tape or disk 

o A tape rather than a disk (or vice versa) 

o A wrong disk type on an IMAGE 

o A device without including a unit number, for example, 
DK: instead of DKO : 

%%% Only nn% of the output disk clusters are available for 
relocation 

Mount it anyway <No>? 

SAVE/RESTORE finds there are few free blocks available for 
relocation on the output disk. 

??? Operation aborted at user request 

You specified the /NOERROR switch and one of the errors 
described in Table E-12 occurred, or you typed NO to a RETRY 
(Yes or No)? question. 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ + 

I Message and Meaning | 

+ + 

| %%% Same device specified j 

| You designated the same device for both input and output. | 

| Specify the correct output device. | 

I %%% Tape won't respond to density XXXX | 

| SAVE/RESTORE attempted to set the density of the specified j 

| magnetic tape to XXXX but the hardware rejected the request. | 

| Specify a density setting that is legal for that device, or | 

| use a different device. | 

| %%% Tape won't respond to any density | 

| The input volume cannot be read at any legal density | 

| setting. | 

| %%% This is not the correct volume | 

| The SAVE Set or Pack ID you specified does not match that on | 

| the mounted device. A DISMOUNT DEVICE message follows the j 

| error message and identifies the volume if it is a SAVE Set | 

I or a RSTS/E file - structured disk. | 

| This message also occurs if SAVE/RESTORE requests the next | 

| volume of a SAVE Set and you specify a device containing a j 

| volume that is not part of the current SAVE Set or is not j 

| the correct sequential volume of the current SAVE Set. j 

I Mount the correct volume. | 

j %%% This volume has no label j 

| SAVE/RESTORE did not find a valid SAVE Set label or Pack ID | 

| on the specified input volume. | 

| %%% Too many bad blocks on input disk j 

| The number of bad clusters on the input disk exceeds the | 

j RSTS/E limit. j 
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Table E-ll: General SAVE/RESTORE Error Messages (Cont.) 

+ + 

| Message and Meaning | 



0.0.0. 



Too many bad blocks on output disk 



The number of allocated clusters on the original source disk 
exceeds the number of available clusters on the output disk 
or the number of bad clusters on the output disk exceeds the 
RSTS/E limit (161 bad clusters). 

Use a different disk pack. 
%%% Unrecognized switch 

You have specified an invalid switch. 

??? Volume is full 

There was not enough room for the relocation of data 
clusters due to the blocks found on the output volume. 

%%% Wrong size disk 

The output volume of an IMAGE or RESTORE must be the same 
size as the original source. See the discussion of LIKE 
disks in the section "Definitions of SAVE/RESTORE Terms." 

%%% You will be writing to the booted device 

If you write to this device, you need to reboot when you are 
finished with SAVE/RESTORE. 



Transfer Errors-Fatal and Nonfatal 

Transfer errors you may find in a SAVE/RESTORE operation can be fatal 
or nonfatal. Fatal transfer errors cause an immediate termination of 
the current operation. Nonfatal errors, if the /NOERROR switch is not 
in effect, let the operation continue despite the problem. On the 
other hand, if you specify the /NOERROR switch and one of the errors 
in Table E-12 occurs, SAVE/RESTORE terminates the operation 
immediately (which indicates the output is not a valid medium). In 
other words, the nonfatal errors listed and described in Table E-12 
become fatal if the /NOERROR is attached to the function response. 

Whether or not you specify /NOERROR, the error message ???Volume is 
full occurs if SAVE/RESTORE cannot relocate a file due to a bad block 
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on the output device. The relocation does not take place because 
SAVE/RESTORE cannot find any additional clusters available or does not 
find as many free clusters as it needed. This results from too many 
bad blocks on the output volume. 

Table E-12 contains a description of all nonfatal transfer errors that 
can occur if you do not specify /NOERROR. 



Table E-12: SAVE/RESTORE Nonfatal Transfer Errors 

+ - + 

| Message and Meaning | 

+ + 

%%% Bad block on input, PCN=nnnnnn 



A bad block was found on an allocated cluster on the input 
volume. A copied version of the data in that block might be 
corrupt. 

%%% Bad block on input, output PCN's affected: 

A bad block was found on the input SAVE Set volume, which 
will affect certain pack clusters on the output disk. A 
copied version of the data in that block might be corrupt. 

%%% Bad block on input: 
in MFD [PCN=nnnnnn] 
in UFD [P,PN] [, PCN=nnnnnn] 
in GFD, nnn [, PCN=nnnnnn] 
in file [ P,PN] FILENAME. TYPE, [PCN=nnnnnn] 

A bad block was found on an allocated cluster on the input 
volume. A copied version of the data in that block might be 
corrupt. 

%%% Bad Compare, PCN=nnnnnn 

The data on the input volume did not compare with the 
corresponding data on the output volume. (See the 
explanation following this table.) 

%%%Bad compare on input: 
in MFD [ PCN=nnnnnn ] 
in UFD [P,PN] [, PCN=nnnnnn] 
in GFD, nnn [, PCN=nnnnnn] 
in file [ P,PN] FILENAME. TYPE, [PCN=nnnnnn] 

The data on the input volume did not compare with the 
corresponding data on the output volume. (See the 
explanation following this table.) 
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Table E-12: SAVE/RESTORE Nonfatal Transfer Errors (Cont.) 

+ + 

| Message and Meaning | 
+ - + 

%%% File XXXXXX has been changed to noncontiguous 

SAVE/RESTORE found a bad block in the output area for file 
XXXXXX. To complete the transfer, one or more blocks of the 
file were relocated. 

Consider the consequences of this change and proceed 
accordingly. 

%%% Placed file XXXXXX has been moved from aaaaaa to bbbbbb 

A bad block was found in the output area for file xxxxxx. To 
complete the transfer, one or more blocks of the file were 
relocated . 

Consider the consequences of this change and proceed 
accordingly . 

+ - - + 

During a verification pass, SAVE/RESTORE may detect differences 
between the input and output. If there are differences, SAVE/RESTORE 
informs you with two types of messages: 

%%%Bad compare, PCN=nnnnn 

%%%Bad compare in [MFD [, PCN=nnnnn]] 

[UFD [p,pn] [, PCN=nnnnn]] 

[GFD, nnn [, PCN=nnnnnn]] 

[file [ p,pn] f ilenam. typ [, PCN=nnnnnn]] 



SAVE/RESTORE first prints a general error message and then, after some 
additional processing, prints the second error message telling you 
more specifically the accounts and/or files in which the bad 
comparisons occurred. 



If you request transfer verification, SAVE/RESTORE checks (after the 
initial transfer phase) whether the data it has written matches the 
corresponding data it read. If there is a difference, SAVE/RESTORE 
prints : 

%%%Bad compare in [MFD [, PCN=nnnnn]J 

The SAVRES program transfers only clusters that are marked as 
allocated in the Storage Allocation Table. During the actual transfer 
and verify pass, it can tell only which Pack Cluster Number (PCN) it 
has completed. If /NOERROR is in effect and you are performing a SAVE 
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or IMAGE copy, SAVE/RESTORE then tries to pinpoint the problem by 
scanning the input directory structure before aborting. If you are 
doing a RESTORE, SAVE/RESTORE simply aborts. This difference exists 
because SAVE/RESTORE must have a complete directory to scan in order 
to find accounts and/or files that caused the problems. In the case 
of a RESTORE, the output volume is not yet complete and SAVE/RESTORE 
cannot scan it. 

If /NOERROR is not in effect, SAVE/RESTORE stores each PCN that caused 
a problem in an internal table as it continues with the verify pass. 
If SAVE/RESTORE finds more entries than can be stored in the table, it 
prints the message: 

"Affected file will not be reported" 

This means there is no more room to store the information. At the end 
of the verification pass, SAVE/RESTORE prints the total number of 
variations found in the form: 

%%% nn differences found 

After completing the transfer, SAVE/RESTORE scans the input (SAVE or 
IMAGE) or (RESTORE) volume directories to find the accounts and/or 
files in which the bad comparisons occurred. Then, it displays one or 
more of the following messages: 

%%%Bad compare in [MFD [, PCN=nnnnn]] 

[UFD [p,pn] [, PCN=nnnnn]] 

[GFD, nnn [, PCN=nnnnnn]] 

[file [p,pn]filenam.typ [, PCN=nnnnnn] ] 
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Device Testing Package (DEVTST) 



The Device Testing Package (DEVTST) exercises hardware on the RSTS/E 
system during normal time -sharing operations. You can use DEVTST to 
simulate hardware errors on the system. 



Introduction to DEVTST 

DEVTST is a package of programs that provides the customer, System 
Manager, or DIGITAL Field Service personnel with tests that verify the 
reliability of RSTS/E- supported hardware. Execution of any DEVTST 
program is limited to users with WREAD privilege. As distributed, 
DEVTST is in TEST$: (by default, [0,5]). 

This appendix explains operational data, conventions, complete device 
testing information, and error messages. After execution of 
individual DEVTST exercisers, you should check the System Error Log 
for additional errors; for more information on the System Error Log, 
see Chapter 10. 

The DEVTST exercisers are tests that can be initiated whenever you 
suspect hardware trouble. These device, exercisers generate excess 
activity in an attempt to make the hardware fail during operation. 

Use the DEVTST package in conjunction with the RSTS/E error package 
(see Chapter 10). The Error Logging facility provides the means for 
determining detailed information on hardware errors. In addition, the 
DEVTST programs return error messages that may be useful in 
determining the failure; however, these messages are not as specific 
as the information provided by the System Error Log. 
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The following conventions are used throughout the DEVTST package 
dialogue: 

< > Indicates the default answer. 

( ) Shows all possible replies. 

[ ] Gives an optional reply; for example, ASC [II] means 

enter ASC, ASCI, or ASCII. 

<ALT MODE> Either key moves the program back one question. If you 
or <ESC> press either key as a response to the first question, 

DEVTST will stop execution and return to the RSTS/E 

command level. 



<CTRL/Z> Pressing CTRL/Z causes the program to stop execution and 

return to RSTS/E command level. CTRL/Z is detected only 
when the system checks for new input. 

<CTRL/C> Pressing CTRL/C causes the program to stop execution 

immediately and return to a command level. 

<RET> Use the RETURN key to terminate the input line. 



Detach <N0> All of the device exercisers have the ability to detach; 

this allows you to run an exerciser while keeping your 
terminal free for other operations. 

-1 Negative one, when used as a value for number of 

iterations, pages, or lines, tells the program to run 
indefinitely, or until you press CTRL/C. 



DEVTST Operating Procedures 
To run a DEVTST program, type: 

RUN TEST$ :program name 
For example: 

RUN TEST$ : KBEXER 
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Device Testing Package (DEVTST) 
Table F-l lists the program names and the hardware they test. 

Table F-l: DEVTST Programs 

+ + + 

| Program | Hardware Tested | 





- + 


CPEXER 


CPU 


CPUTST 


| CPU 


DSKEXR 


| File - structured disk 


DSKSEK 


| Non - file - structured disk 


DTEXER 


| DECtape 


DXEXER 


| Diskette 


KBEXER 


| Terminal 


LPEXER 


| Line printer 


MTEXER 


| Magnetic tape 


PPEXER 


| Paper tape punch 


PREXER 


| Paper tape reader 




- + 



Table F-2 gives a complete list of RSTS/E supported hardware, 
including designators and the associated devices. 



Table F-2: RSTS/E Device Designators 



Device 


Designator 


- + 

| Device 




DK: , 
DR: , 


DL 
DB 


:, DM:, 
:, DU:, 


DP : , 
SY: 


- + 

| RSTS/E public disk structure 




SYO: 








| System disk (the unit that was 


bootstrapped) 


DVO : 








| Virtual disk, unit only 




DKO: 


to 


DK7 : 




| RK05/RK05F disk cartridge units 


to 7 


DLO : 


to 


DL3 : 




| RL01/RL02 disk cartridge units 


to 3 


DM0: 


to 


DM7 : 




| RK06/RK07 disk cartridge units 


to 7 


DPO: 


to 


DP7 : 




| RP02/RP03 disk pack units to 


7 


DRO: 


to 


DR7 : 




| RM02/RM03/RM05/RM80 disk units 


to 7 


DBO : 


to 


DB7 : 




| RP04/RP05/RP06 disk pack units 


to 7 
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Table F-2: RSTS/E Device Designators (Cont.) 



+ + + 

| Device Designator | Device | 



niTrt . 

uuu : 


4- r\ 


T\TT"7 . 


1 DRCn T? a Q n DjQl npTC TJT»t;i T5r»t>9 dy^H 
1 KADU , KAOU , KAOi r KLZ J r tiUOXf KUDZ, , KADU 

1 disk units to 7 


PR: 






| High-speed paper tape reader 


PP : 






| High-speed paper tape punch 


CR: 






| CR11 punched or CMll mark sense card reader 


CD: 






j CDll punched card reader 


MTO: 


to 


MT7: 


| TE10/TU10/TS03 magnetic tape units to 7 


MSO: 


to 


MS3: 


| TS11/TSV05/TK25/TU80 magnetic tape units 
to 3 


MMO : 


to 


MM7: 


| TE16/TU16/TU45/TU77 magnetic tape units to 

1 7 


LPO: 


to 


LP7: 


j Line printer units to 7 


DTO: 


to 


DT7: 


j TU56 DECtape units to 7 



DEVTST Dialogue Errors 

Table F-3 lists the error messages that can occur in DEVTST programs. 
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Table F-3: DEVTST Error Messages 

+ + 

| Message and Meaning | 
+ + 

%Warning: <device name) is a logical device: <device name) will be 
used. 

DEVTST determines that the device name given is a logical name 
for another device. DEVTST performs a logical device 
translation and the translated device name is used. 

Plllegal device: <device name) specified. 

The device name given by the user is either incorrect or is a 
logical device name that cannot be translated (for example, 
incorrect characters or the wrong type of device). Retry the 
operation with the correct device name. 

?OPEN failure on <device name): 

(Followed by an error message from Appendix A of the RSTS/E System 
Installation and Update Guide.) 

This error message can mean one of the following: 

o The device specified does not exist 
o No volume was mounted on that device 
o Another user has assigned the device 
o The volume on the device has not been formatted 
o The device is not on-line or the device is not 
write-enabled 

To resolve: retry the operation using the correct option as 
determined by the error message received. 

?Illegal number of iterations selected. 

Retry the operation using the correct number of iterations. 



CPEXER 

The central processor exerciser is designed to put a heavy load on the 
Central Processing Unit (CPU). CPEXER runs compute bound for bursts 
and then sleeps for five seconds so the average processor loading does 
not appreciably degrade the performance of the system. 
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CPEXER was specifically designed to test the Floating Point Processor 
(FPP) option, but also serves to verify general CPU integrity and the 
Extended Instruction Set (EIS) operation. There is also a test of the 
PEEK function for kernel addresses through 22000. 

The next section itemizes the tests performed by CPEXER. In most of 
the tests, CPEXER compares the results to known correct values. Two 
heavily compute -bound tests are included to verify consistent results 
of duplicate calculations. Finally, CPEXER includes tests that verify 
FPP divide by zero trap, integer divide by zero trap, integer 
conversion error, and EIS operation. 



CPEXER Tests 

The CPEXER program includes the following 13 CPEXER tests: 
Test Description 

SIN(X) Uses SIN(X) extended function 

SIN(X) Uses polynomial approximation to SINE function 

LOG(X) Uses LOG(X) extended function 

EXP(X) Uses EXP(X) extended function 

SQR(X) Uses SQR(X) extended function 

SQR(X) Uses Newton-Raphson method to determine the square 

root 

LOG(EXP(X)) Compute -bound test 

ATN ( TAN ( X ) ) Compute-bound test 

A=l. 0/0.0 Verifies FPP divide by zero trap 

A%=l%/0% Verifies integer divide by zero trap 

A%=60000 Verifies integer conversion error 

INT(40. 6621*100+0. 5)/100=40. 66 Verifies EIS operation 

PEEK(X) Verifies operation of PEEK function 



F-6 



Device Testing Package (DEVTST) 

CPEXER Dialogue 

The following is an example of the CPEXER dialogue: 

$ RUN TEST$: CPEXER CPEXER V9 . RSTS V9 . EDERE 
How many minutes to run <15>? 1 
Detach <No>? no 

11.9 seconds of CPU time used in 1 pass. 

CPEXER finished at 03:36 PM 

$ 

Note 

The CPEXER program will build correctly only if the 
version of BASIC-PLUS or BASIC-PLUS-2 includes TRIG 
and LOG. These mathematical functions must be 
included during system installation of BASIC-PLUS or 
the installation of BASIC-PLUS-2. 

CPEXER Errors 

This program reports four types of errors: 

1. Instructions failed to execute. 

2. Errors failed to trap. 

3. Computation errors. 

4. Computation consistency checks failed. 

Check the System Error Log for reported errors. These errors may 
indicate hardware problems. 

When type one errors (instruction errors) occur, CPEXER prints a 
two-line message: the first line gives the test that was being 
performed and the exact error message, and the second line indicates 
that the test is continuing. For example: 

7CPEXER PEEK failed at memory location m. 
-(Error Message) 

Continuing 
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where : 

(Error Message) is the RSTS/E error message from Appendix A 

of the RSTS/E System Installation and Update 
Guide . 

m is the memory location at which the PEEK 

function failed. 



Examples of type 2 errors (trap failure) are: 
?CPEXER Floating point divide by didn't trap 
Continuing 

7CPEXER Integer divide by didn't trap 
Continuing 

7CPEXER Forced integer conversion didn't trap 
Continuing 

?CPEXER (INT(40, 6621*100=0. 5) )/100< >40.66 
Continuing 

Type three errors (computation errors) give the type of test 

( SIN,PLYNOM, LOG, EXP, SQR, or NEWTON SQR), the error in the computed 

value, and the location of the possible error. For example: 

7CPEXER - SIN test failed for the following cases: 
7CPEXER - Computed value of SIN(40) was .643, should be .64 
7CPEXER - CPU,EIS, FIS, FPP,MUL,DIV or SHIFT Error 
Continuing . . . 

7CPEXER - PLYNOM SIN test failed for the following cases: 

7CPEXER - Computed value of PLYNOM SIN (40) was .643, should be .64 

7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 

Continuing . . . 

7CPEXER - LOG test failed for the following cases: 

7CPEXER - Computed value of LOG (140) was 4.942, should be 4.939 

7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 

Continuing ... 

7CPEXER - EXP test failed for the following cases: 

7CPEXER - Computed value of EXP (4) was 54.598, should be 54.599 

PCPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 

Continuing . . . 
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7CPEXER - SQR test failed for the following cases: 

7CPEXER - Computed value of SQR (500) was 22.361, should be 22.362 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing ... 

7CPEXER - NEWTON SQR test failed for the following cases: 

7CPEXER - Computed value of NEWTON SQR (500) was 22.361, should be 

22.362 

7CPEXER - CPU,EIS,FIS, FPP,MUL,DIV or SHIFT Error 
Continuing . . . 

Type four errors (consistency failure) in the CPEXER are shown in the 
following examples: 

7CPEXER - EXP/LOG Consistency check failed for the following cases: 
7CPEXER - EXP(LOG(...( 1 )))))))))) <> EXP(LOG(...( 1)))))))))) 
7CPEXER - EXP(LOG(...( 4 )))))))))) <> EXP(LOG(...( 4)))))))))) 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing . . . 

?CPEXER - ATN/TAN Consistency check failed for the following cases: 
PCPEXER - ATN(TAN( . . . ( -1.5 )))))))))) <> ATN ( TAN (...(- 1 . 5 )))))))))) 
?CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing . . . 



CPUTST 

The CPUTST dialogue first asks how many minutes you want the test to 
run. The program then: 

1. Checks for expiration of this request time at eight strategic 
points during each run sequence 

2. Clears and/or sets three 2 -dimensional arrays to specified 
values 

3. Transposes Matrix A and places the result in Matrix B 

4. If no errors are found, returns to Step 2 

5. If an error is found, reports the error and aborts the test 

The program repeats this process until the run time expires, at which 
time it prints the CPU time in seconds of expended job time. 
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CPUTST Dialogue 

The following is an example of CPUTST dialogue: 

$ RUN TEST$: CPUTST 

CPUTST V9.0 RSTS V9 . EDERE 

How many minutes to run <15>? l 

Detach <No>? NO 

6.9 seconds of CPU time used. 

CPUTST Finished at 10:59 AM 

$ 



CPUTST Errors 

This device exerciser reports errors as 
examples : 

?CPUTST-Error in matrix transposition 
?( Error message) at line mm in CPUTST 
where : 

(Error Message) is the RSTS/E message in Appendix A of the RSTS/E 

System Installation and Update Guide for the error 
that occurred. 

mm is the BASIC-PLUS line number in CPUTST where the 

error occurred. 

Check the System Error Log for reported errors. These errors may 
indicate hardware problems. 

If your hardware does not include a floating point processor (FPP), 
submit a Software Performance Report (SPR) to DIGITAL whenever errors 
appear. 



DSKEXR 

This disk exerciser tests the normal operation of all file - structured 
disks. It is possible to run several copies of DSKEXR in order to 
test several drives simultaneously or to put a heavier load on any 
single drive. The disk must be physically and logically mounted. 



shown in the following 

routine . 
V9.0. 
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DSKEXR begins by asking questions to determine the disk drive to be 
tested and the number of test iterations to be performed. 

After this dialogue, the exerciser: 

1. Opens and extends a temporary file to a predetermined size 
that is dependent upon disk size and the number of free 
blocks 

2. Loads a pattern buffer with one of four patterns (all l's and 
O's or a pattern of alternating l's and O's) 

3. Writes the file 

4. Reads each block and compares it for each of the patterns. 

Upon completion of all iterations for each drive you specify, DSKEXR 
prints a status report. 

Note 

This write operation does not use current disk files 
to read and write. The temporary file will always be 
deleted after use, regardless of how the DSKEXR 
program is terminated. Be sure to turn off data 
caching before you run this test. 



DSKEXR Dialogue 

The following is an example of DSKEXR dialogue: 

$ RUN TEST? : DSKEXR 

DSKEXR V9.0 RSTS V9 . EDERE 

Disk drive to test? DBl : 

Number of test iterations <8>? i 

Detach <No>? no 

No errors detected on _DB1 : 

$ 
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DSKEXR Errors 

DSKEXR reports errors as shown in the following examples: 

?(Error message) error at line mm in DSKEXR V9.0 

?nn errors detected on DBn. 
where: 

(Error message) is the RSTS/E message in Appendix A of the RSTS/E 

System Installation and Update Guide for the error 
that occurred. 

mm is the line number where the error occurred in the 

DSKEXR program. 

nn is the number of errors detected by DSKEXR. 

When DSKEXR detects errors, do the following: 

1. Check to make sure that the volume is physically mounted and 
write-enabled. 

2. Check to make sure that the volume is logically mounted. 
This may be verified by the use of the SHOW DISKS command. 
If the disk is not mounted, use the MOUNT command (see 
Chapter 15 ) . 



Caution 

Note the following to avoid damage to the system: 

o Packs mounted as unlocked public disks will be 
available to other system users for creation and 
storage of their files. Subsequent removal of a 
public disk may result in the elimination of 
these user files from the system. For this 
reason, DIGITAL recommends the use of a private 
pack if a nonsystem disk is to be tested. 

o Never mount a potentially bad disk on another 
drive until you are sure that the drive and pack 
are free of physical damage. 



Persistent errors may be due to bad blocks on the pack. Any 
potentially bad blocks will be flagged in the System Error Log 
following unsuccessful access, to prevent further access to the INIT 
option . 
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DSKSEK 

This disk exerciser tests the normal operation of non- file - structured 
disks by randomly reading blocks from the disk. It is possible to run 
several copies of DSKSEK in order to test several drives 
simultaneously or to put a heavier load on any single drive. If the 
disk being tested is a mounted RSTS/E file - structured disk, DSKSEK 
will not read the known bad blocks. If an error occurs on a read 
operation, DSKSEK reports it will be reported by DSKSEK and logs it 
into the System Error Log. 

Note 

This is a read-only operation. Turn off data caching 
before you run this test. 



DSKSEK Dialogue 

The following is an example of DSKSEK dialogue: 

$ RUN TEST$: DSKSEK 

DSKSEK V9.0 RSTS V9 . EDERE 

Disk drive to test? DBO: 

Number of test iterations <30>? 1 

Detach <No>? NO 

No bad block detections in 1000 sets from _DB0: 
$ 

DSKSEK Errors 

Errors detected by DSKSEK are displayed as follows: 
?(Error message) error at line mm in DSKSEK V9 . . 
where : 

(Error Message) is the RSTS/E message in Appendix A of the RSTS/E 

System Installation and Update Guide, 

mm is the BASIC-PLUS line number where the error 

occurred in the DSKSEK program. 
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When DSKSEK detects errors, do the following: 

1. Check to see if the volume on the testing device is 
physically mounted. 

2. If it is, mount another scratch volume on the drive and retry 
the operation. 

Caution 

Never mount a potentially bad disk on another 
drive until you are sure that the drive and 
pack are free of physical damage. 

3. If the test continues to fail, check the System Error Log to 
see if bad blocks are recorded. 

4. If bad blocks are recorded, add them to the bad block list on 
the disk using the REFRESH BADS suboption of INIT. This can 
only be done if the disk has been initialized (DSKINTed) as a 
RSTS/E disk. (See the RSTS/E System Installation and Update 
Guide for information on BADS.) 

5. If the problems continue, get a complete listing of the 
System Error Log (using the ERRDIS program). 



DTEXER 

The DECtape exerciser tests the normal operation of the TC11 DECtape 
control and TU56 DECtape drives. DTEXER opens a file on the drive 
being tested and fills the file with floating point numbers. The 
program writes 420 blocks (of a possible 578 blocks) on the tape. 
Numbers written on the tape are read and checked, keeping a count of 
incorrect values. If at the end of the test the error count is not 0, 
DTEXER prints the error count. 

Caution 

Any information previously contained on the DECtape 
used for this test will be destroyed. 
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DTEXER Dialogue 

The following is an example of DTEXER dialogue: 

$ RUN TEST$: DTEXER 

DTEXER V9.0 RSTS V9 . EDERE 

Warning: This exerciser will destroy data on the tested DECtape. 

Dectape drive to test? DTI: 

Number of iterations <2>? 1 

Detach <No>? NO 

No errors detected on _DT1 : 

DTEXER Finished at 04:13 PM 

$ 



DTEXER Errors 

This device exerciser shows the number of errors found during 
operation, as shown in this example: 

?mm errors on DTn during iteration nn. 

where : 

mm is the number of errors detected by the DTEXER program. 

DTn is the name of the device being tested. 

nn is the number of the iteration during which the error 
occurred. 

When DTEXER detects errors, do the following: 

1. Check to see if the DECtape on the testing device is 
physically mounted and write -enabled. 

2. If it is, mount another scratch DECtape on the drive and 
retry the operation. 

3. Check to make sure that the tape path and heads are free of 
oxide . 
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DXEXER 

This exerciser tests the normal operation of the diskette controller 
and the specified diskette drives. DXEXER starts by opening the 
floppy and writing 420 blocks of floating point numbers to it. These 
are written on the drive being tested, then read back and verified. 
The program then displays the number of words written and read, and 
the number of errors detected. 

Caution 

DXEXER destroys any information previously contained 
on the diskette used for this test. 



DXEXER Dialogue 

The following is an example of DXEXER dialogue: 

$ RUN TEST$ : DXEXER 

DXEXER V9.0 RSTS V9 . EDERE 

Warning: This exerciser will destroy data on the tested flexible 
diskette . 

Flexible drive to test? DXO : 
Number of iterations <20>? 2 
Detach <No>? NO 

Flexible diskette DXEXER I/O data 

Device Reads Words Writes Words 

JDXO: 300 76.8 K 300 76.8 K 

DXEXER Finished at 10:53 AM 

$ 
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DXEXER Errors 

DXEXER shows the number of errors detected during operation as shown 
in this example: 

?mm errors on DXn during iteration nn. 

where: 

mm is the number of errors detected by the DXEXER program. 

DXn is the name of the device being tested. 

nn is the number of the iteration during which the error 
occurred . 

When DXEXER detects errors, do the following: 

1. Check to see if the flexible diskette on the testing device 
is physically mounted and the door closed. 

2. If it is, mount another scratch flexible diskette on the 
drive and retry the operation. 



KBEXER 

The keyboard exerciser (KBEXER) is used to test local and remote 
terminals connected to the RSTS/E system. The three terminal tests 
are as follows: 

o The Space Test -- Verifies that the terminal carriage will 
return reliably from any position 

o The ASCII Pattern Test -- Verifies that the terminal will 

print the standard ASCII character set in all print positions 

o The Repeat Test -- Repeats everything typed, one line at a 
time 



Note 

You can terminate the tests at any time by pressing 
CTRL/C. You can obtain HELP by typing HELP in answer 
to any dialogue question. 
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KBEXER Dialogue 

The following is an example of KBEXER dialogue: 

$ RUN TEST$: KBEXER 

KBEXER V9.0 RSTS V9 . EDERE 

Keyboard to test <_KB68:>? <RET> 

Test (SPA[CE], ASC[II], WOR[ST], REP [ EAT ] , HEL [ P ] ) ? ASC 

Number of test iterations <8>? 1 

Detach <No>? NO 

*** ROTATING ASCII CHARACTERS TEST *** 

#$%&' ()*+,- ./0123456789: ;< = >? @ABCDEFGH I JKLMNOPQRSTUVWXYZ [\]* !"#$%& 
"#$%&' ()*+,- ./0123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\]~ • "#$% 
i "#$%&' ()*+,- ./0123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\;f _ ! "#$ 
! "#$%&' ()*+,- ./0123456789: ;<=>? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [ \]~ _ 1 "# 
_ !"#$%&' ( ) * + , - ,/0 123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\]~ I" 
~_ !"#$%&'()*+/- ./0123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [ \]~ _ 1 
r I "#$%&' ()*+,- ./0123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\]* _ 

!"#$%&'()*+,- ./01234 56789: ;<=>? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\]"_ 
[\r _ !"#$%&'()*+»" ./01 2 34 56789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [ \]~ 
Z[\r _ i "#$%&' ()*+,- ./0123456789: ;< = >? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [ \] 
YZ[\]~__ 1 "#$%&' ()*+,- ./0123456789: ;<=>? @ABCDEFGHI JKLMNOPQRSTUVWXYZ [\ 



KBEXER Finished at 10:33 AM 
$ 



KBEXER Errors 

Errors detected by KBEXER appear as errors in the keyboard test 
patterns. Visually check the patterns for errors. 



LPEXER 

This exerciser prints a rotating pattern of ASCII characters on a 
specified number of pages and is used to test any line printer. 
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LPEXER Dialogue 

The following is an example of LPEXER dialogue: 

$ RUN TEST$: LPEXER 

LPEXER V9.0 RSTS V9 . EDERE 

Line printer to test? LPO : 

Number of pages to output <4>? 1 

Detach <No>? NO 

LPEXER finished at 11:38 AM 

$ 



LPEXER Errors 

Problems found on the line printer appear as errors in the print-out 
of ASCII characters. Visually check the line printer listing and if 
an error message is printed by LPEXER, check to make sure that the 
line printer selected is on-line and not out of paper. 



MTEXER 

The magnetic tape exerciser checks normal operation of the TMll or 
TS11 magnetic tape controller, the RH11/RH70/TM02/TM03 controller, and 
the specified number of 9-track TE10, TU10, TS03, TS11, TU16, TE16, 
TU45, or TU77 drives. MTEXER allows you to select the drive to be 
tested, the length of tape to be written and the number of iterations 
to be performed. For each iteration, MTEXER initializes the tape, 
opens a file and writes data until the specified length of tape has 
been used. MTEXER then rewinds the tape, opens the file for input, 
reads and verifies the data. If errors are detected, MTEXER prints a 
count of the number of bytes found to be incorrect; MTEXER then 
proceeds to the next iteration. 

The data pattern used is a worst case NRZI pattern for 9-track drives. 
The pattern is loaded into a 512-byte buffer, and successively greater 
numbers of records are written to the magtape until the requested 
length of tape has been written. Furthermore, the pattern base varies 
with X so that the contents of the pattern buffer also varies on 
successive iterations. 
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Caution 

This exerciser overwrites data contained on the 
magnetic tape used for the test. 



MTEXER Dialogue 

The following is an example of MTEXER dialogue: 

$ RUN TEST$: MTEXER 

MTEXER V9.0 RSTS V9 . EDERE 

Warning: This exerciser will destroy data on the tested magtape. 

Magtape drive to test? MT2 : 

Density (800 or 1600) <800>? <RET> 

Number of feet to test <100>? <RET> 

Number of iterations <2>? 1 

Detach <No>? 

Magtape MTEXER I/O Data 

Device Reads Words Writes Words 

_MT2: 387 99.072 K 387 99.072 K 

No errors detected on _MT2: 

$ 

MTEXER Errors 

Magtape errors are reported in these formats: 

PMagtape select error at line nn in MTEXER V9.0. 
?MTEXER-Selection error occurred. 

where : 

nn is the line number in MTEXER at which the error occurred. 
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When MTEXER detects errors, do the following: 

1. Check to see if the volume on the testing device is 
physically mounted, write -enabled, and assigned to you. 

2. If it is, mount another scratch volume on the drive and retry 
the operation. 

3. Check to make sure that the tape path and heads are free of 
oxide. 



PPEXER 

This program tests the normal operation of the paper tape punch by 
punching random patterns on the paper tape for input into the PREXER. 



PPEXER Dialogue 

The following is an example of PPEXER dialogue: 

$ RUN TEST$: PPEXER 

PPEXER V9.0 RSTS V9 . EDERE 

This test will punch a binary count pattern tape. 

The tape will be equivalent to MAINDEC- 00-D2G4 entitled 

Special Binary Count Pattern Tape. 

Detach <No>? NO 

The generated paper tape may be used to test the paper tape 
reader . 

PPEXER finished at 11:23 AM 
$ 



PPEXER Errors 

Problems in the paper tape punch results in an incorrectly generated 
paper tape, which is detected by PREXER when the tape is read. If 
PPEXER prints an error message, check to see that the paper tape punch 
is on line and not out of paper tape. 
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PREXER 

This program tests the normal operation of the paper tape reader by 
reading the paper tape punched by the PPEXER program. 



PREXER Dialogue 



The following is an example of PREXER dialogue: 



$ RUN TEST$: PREXER 

PREXER V9.0 RSTS V9 . EDERE 



Load MAINDEC- 00 -D2G4 -PT or the binary count pattern 
tape generated by the punch exerciser into the reader 
with the leader under the read station. 

Detach <No>? no 

No errors detected on paper tape. 

PREXER finished at 11:29 AM 

$ 



PREXER Errors 

PREXER reports any errors in this format: 

?nn errors detected on paper tape 
where: 

nn is the number of errors detected by the PREXER program. 

Note 

If the paper tape was loaded backwards and the reader 
is operating correctly, the following error message 
is printed: 

715360 errors detected on paper tape 

Any other errors that PREXER detects may indicate a hardware problem 
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-A- 

ABORT command 

OPSER, A-63 

SPOOL, A-36, A-48 
/ABORT qualifier 

STOP/QUEUE/MANAGER command, 
9-52 

Accessing entries 
entry number, 9-9 
entry specification, 9-9 

Account 

associated with system logical 

name, 12-12 
nonuser, 7-2 

programming error in privileged, 
2-6 

user, 7-2 
Account attribute 

captive flag, 7-5 

dial-up flag, 7-6 

network flag, 7-6 
Account management 

GACNT privilege, 6-4 

WACNT privilege, 6-9 
Account management, DCL commands, 
7-lt 

/ACCOUNT_DATA qualifier 

BACKUP command, 16-4 

RESTORE command, 16-14 
/ACCOUNTING JDATA qualifier 

SHOW ACCOUNT command, 7-22 
Action requests 

BATCH, A- 57 

OPSER, A-13 

table of, A-13 
/ADDRESS qualifier 

INSTALL/LIBRARY command, 12-30 

INS TALL/RUNT I ME__SYSTEM command, 
12-33 

/AD VAN C E D__ V I D E qualifier 

SET TERMINAL command, 8-10 
AFTER state, processing entries, 
9-8 

/ALIGN switch, SPOOL, A- 51 

/ALL qualifier 

BROADCAST command, 13-12 
DEALLOCATE command, 11-17 
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DEAS SIGN/QUEUE command, 9-27 
DELETE/COMMAND/SYSTEM command, 
12-27 

FORCE command, 13-14 
LOAD/OVERLAY command, 14-30 
SET CACHE command, 11-21 
SET QUEUE command, 9-38 
SET SERVER command, 9-41 
SHOW ACCOUNT command, 7-22 
SHOW DEVICE command, 11-28 
SHOW FILE/SYSTEM command, 12-46 
SHOW LOGICAL/SYSTEM command, 
12-49 

SHOW LOGICALS command, 12-48 
SHOW PRINTER command, 11-30 
SHOW SERVER command, 9-44 
SHOW TERMINAL command, 8-20 
UNLOAD/OVERLAY command, 14-38 

ALLOCATE command, 11-16 

/ALLOCATED qualifier 

SHOW DEVICE command, 11-28 

/ALT_MODE qualifier 

SET TERMINAL command, 8-10 

ANALYS 

crash dump data, 10-29 

crash error code, 10-29t 

CRASH. SYS, 12-22 

create error logging file, 10-1 

dialogue questions, 10-29t 

output, 10-29 

run, 10-27 

running after crash, 3-10 

START.COM commands, 10-30 

use, 10-27 
/ANSI qualifier 

SET TERMINAL command, 8-10 
ANSWER command 

BATCH, A- 57 

OPSER, A-15 
ASSIGN option, SPOOL, A-33 
ASSIGN/QUEUE command, 9-25 
ASSIGN/SYSTEM command, 12-13, 
12-24 

ATTACH command, 13-10 
Attributes, printer forms, 9-17 
/AUTOBAUD qualifier 

SET TERMINAL command, 8-1, 8-11 



Index - 1 



/AUTOBAUD qualifier (Cont.) 

TERSPD.SYS file, 8-3 
Automatic restart 

after power fail, 2-8 

procedures, 2-3 

RSTS/E system, 2-3 

system initialized, 2-7 
Auxiliary run-time system, 12-4 

adding, 12-5 

creation of, 12-5 

removing, 12-6 

START.COM, 12-5 

-B- 

/BACKSPACE qualifier 

SET PRINTER command, 11-23 

START/SERVER command, 9-49 
BACKUP command, 16-3 to 16-11 

quick reference table, 16-llt 
Backup sets 

restrictions, 16-10 
BACKUP, comparison with 

SAVE/RESTORE, E-l 
Bad blocks 

adding to BADB.SYS, 10-10 

adding, caution, 10-10 

criteria, 10-9 

during RESTORE, E-20 

end of file, E-9 

ERRDIS example, 10-9 

ERRDIS prints list, 10-10 

ERRDIS report, 10-9 

list of potential, 10-5 

report content, 10-9 

SAVE/RESTORE file changes, E-42 

SAVE/RESTORE output, E-41 
BADB.SYS file 

adding bad blocks, 10-10 
Base priority 

SET JOB/PRIORITY command, 6-8 

TUNE privilege, 6-8 

UU.PRI system directive, 6-8 
BASIC -PLUS 

keyboard monitor, 1-2 

run-time system, 12-4 
BATCH, A- 2 

ANSWER command, A- 57 

answering action requests, A-57 

communication paths, A-6 

CONTINUE command, A- 58 

default conditions for, A-53 



BATCH (Cont.) 

default receiver identification, 
A-53 

device type designators, A-57t 

dismount a volume, A- 58 

error checking, A-53 

interrupt commands, A-56t 

logical device name, A-52 

modules, A-52 

mount requests, A-57 

OPSER communicate with, A-55 

OPSER package, A-52 

overview, A-6 

processing command file, A-57 
processor, A-52 
pseudo keyboard, A-52 
requests for operator action, 

A-56 
run, A-52 

start-up options, A-54t 
start-up procedures, A-56 
Batch jobs, exit status messages, 
9-16 

/BATCH qualifier 

INITIALIZE/QUEUE command, 9-31 
SET SERVER command, 9-41 
SHOW SERVER command, 9-44 

Batch servers 

CPU limits, 9-16 
Print/Batch Services (PBS), 9-3, 
9-15 

pseudo keyboards, 9-15 

time limits, 9-16 

wildcard names, 9-15 
BATCH. DCD file 

command decoding, A-6 
/BELL qualifier 

BROADCAST command, 13-12 
Bit 0, setting, 2-7 
/BLOCK_SIZE qualifier 

BACKUP command, 16-5 
Bootable medium, create with 

SAVE/RESTORE, E-34 
Bootstrap 

RSTS/E after system halt, 2-3 

RSTS/E into memory, 2-2 
Bootstrap procedure, 2-2 
/BREAK qualifier 

SET TERMINAL command, 8-11 
/BRIEF qualifier 

SHOW ACCOUNT command, 7-23 

SHOW SERVER command, 9-44 
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/BRIEF qualifier (Cont.) 

SHOW TERMINAL command, 8-20 
BROADCAST command ,13-3, 13-11 

SEND privilege, 6-6 
/BROADCAST qualifier 

SET TERMINAL command, 8-11 
/BROADCAST qualifier, permits 
receiving broadcasts, 8-7 
Bucket size 

cache, 11-13 

RMS, 11-14 
Buffer status report, SHOW 
BUFFERS command, 12-20 
/BUFFER_QUOTA qualifier 

SET TERMINAL command, 8-11 
/BUFFER__SIZE qualifier 

BACKUP command, 16-5 

RESTORE command, 16-14 
/BUFFERS qualifier 

SET CACHE command, 11-21 
Burst pages, A-34 
BYE command, CCL, 3-9 

-C- 



Cache 

clusters in, 11-10 

data block, 11-9 

size of, 11-10 

space for, 11-10 

updated by the monitor, 11-10 
Cache cluster 

eligible for replacement, 11-11 

last block in, 11-11 

size of, 11-10, 11-19 

specify size of, 11-20 
/CACHE qualifier 

SET FILE command, 12-43 
Caching 

see also Data caching 

see also Directory caching 

checks by monitor, ll-19f 

directory, 11-9 

efficiency of, 11-13 

guidelines, 11-13, 11-14 

MODE checks, 11-13 

optimize directory, 11-14 

override UFD entry, 11-13 

random mode, 11-11 

RMS indexed file, 11-14 

sequential mode, 11-11 

types, 11-9 



Caching ( Cont . ) 

UFD entry marked for, 11-11 
Caching Control, DCL commands, 
11-lt 

Captive account flag, 7-5 
/CAPTIVE qualifier 

CREATE/ACCOUNT command, 7-9 

SET ACCOUNT command, 7-17 
Catastrophic error, 2-3, 2-7 

automatic recovery, 2-7 

automatic recovery from, 2-5 

cause, 2-5, 2-7 

handling, 2-7 

recovery, 2-7 
CCL (Concise Command Language) 

adding CCL commands, 12-14 

adding in sequence, 12-16 

BYE command, 3-9 

command definition, 3-9 

defined at start of time 
sharing, 12-14 

definition, 1-1 

error checking, 12-15 

HELLO command, 3-9 

listing, 12-16 

PLEASE, A-61 

redefining , 3-9 

removing CCL commands, 12-17 

run RSTS/E programs, 12-14 

use of small buffers, 3-9 
CCL command, definition, 12-14 
Central Processing Unit 

see CPU 
CHANGECONSOLE command 

OPSER, A-17 
CHARS. QUE file, A- 48 

character generation, A-6 
/CLOSE qualifier 

DETACH command, 13-13 

INITIALIZE/QUEUE command, 9-31 
CLOSE/QUEUE command, 9-26 
Cluster size 

cache and pack, relationship, 
11-12 

cache and RMS bucket size, 
11-13 

disk type, 15-8t 
/CLUSTER_SIZE qualifier 

CREATE/ACCOUNT command, 7-9 

INITIALIZE command, 15-8 
/CLUSTERSIZE qualifier 

SET CACHE command, 11-21 
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/132_COLUMNS qualifier 

SET TERMINAL command, 8-10 
Command file 

QUEMAN start-up, A-26 

system start-up, 3-3 
Command level 

system, 1-11 

terminal at, 1-11 
Command line, full function 

(RESTORE), E-34 
Commonly Used System Program 

see CUSP 
Concise Command Language 

see CCL 
Console terminal 

ability to log on to, 13-2 

change, 13-2 

run SHUTUP from, 4-1 
CONTINUE command 

BATCH, A- 58 
/CONTROL qualifier 

SET TERMINAL command, 8-11 
Controlled access 

privilege, 1-11 
/CONTROLS qualifier 

INITIALIZE/SERVER command, 9-34 

SET PRINTER command, 11-24 

SET SERVER command, 9-42 
CPEXER program 

CPU exerciser, short, F-5 

CPU integrity test, F-6 

EIS operation test, F-6 

example dialogue, F-7 

FPP test, F-6 

LOG feature requirement, F-7 

PEEK function test, F-6 

tests performed, F-6 

TRIG feature requirement, F-7 

type four errors, F-9 

type one errors, F-7 

type three errors, F-8 

type two errors, F-8 
CPU (Central Processing Unit) 

determine the state of, 2-5 
CPU exerciser, F-5 
CPU integrity test 

CPEXER program, F-6 
/CPU_LIMIT qualifier 

INITIALIZE/QUEUE command, 9-31 

SET QUEUE command, 9-38 
CPUTST program, F-9 

errors, F-10 



CPUTST program (Cont.) 

example dialogue, F-10 
/CR_PREFIX qualifier 

SET PRINTER command, 11-24 
Crash 

analyzing system, 10-27 
causes of system, 2-7 
documenting system, 10-27 
error code, 10-29 
handling of system, 2-7 
memory dump, annotated version, 
10-29 

OPSER starts after system, A-18 
random system, 2-7 
running QUEMAN after system, 
A-27 

system, 2-3, 2-7 
Crash file 

CRASH. SYS, 12-22 

information from, 10-1 
CRASH. SYS file, 10-1, 10-27 

crash dump, 12-22 
Create access 

GWRITE privilege, 6-4 

WWRITE privilege, 6-10 
CREATE/ACCOUNT command, 7-8 
/CREATED qualifier 

BACKUP command, 16-5 

RESTORE command, 16-15 
/CRFILL qualifier 

SET TERMINAL command, 8-12 
CTRL/C 

do not use in QUEMAN, A- 23 
FORCE, 13-4 

SAVE/RESTORE dialogue, E-8 
typed at terminal, 1-11 

CTRL/Z 

FORCE command, 13-5 
SAVE/RESTORE dialogue, E-8 

CUSP (Commonly Used System 
Program) 
definition, 1-3 

-D- 

Data access, cached, 11-11 
Data block 
cache, 11-9 

retrieval pointer, 11-3 
Data caching 

see also Caching 

cache clusters used, 11-20 
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Data caching (Cont.) 
control, 11-9 
disabling, 11-20 
enable on the system, 11-18 
guidelines, 11-12 
memory access, 11-9 
minimum residency time, 11-15 
MODE values, 11-9 
monitor directives, 11-9 
read operations, 11-9 
restriction with DSKSEK program, 
F-13 

RMS files, 11-14 

support for, 11-9 

write operations, 11-9 

XBUF allocation, 11-10 
/DATA_MAX I MUM qualifier 

SET CACHE command, 11-21 
/DATE qualifier 

INITIALIZE command, 15-9 
/DATE_FORMAT qualifier 

SET SYSTEM command, 14-32 
DATES privilege 

system clock, 6-3 
DCL (DIGITAL Command Language) 

caution when defining, 3-9 

CCL commands, 3-9 

definition, 1-1 

keyboard monitor, 1-2 
DCL command descriptions 

account management, 7-7 to 7-25 

BACKUP, 16-3 to 16-11 

caching control, 11-15 to 11-30 

device management, 11-15 to 

11- 30 

disk handling, 15-3 to 15-25 
job management, 13-9 to 13-22 
managing logical names, 12-23 

to 12-52 
managing system files, 12-23 to 

12- 52 

Print/Batch Services Package 

(PBS) , 9-24 to 9-54 
RESTORE, 16-12 to 16-21 
system functions, 14-28 to 

14-38 

tape handling, 15-3 to 15-25 
terminal management, 8-8 to 
8-21 
DCL commands 

account management, 7 -It 
disk handling, 15-lt 



DCL commands (Cont.) 
job management, 13-lt 
logical names, managing, 12-lt 
Print/Batch Services Package 

(PBS), 9-lt 
system files, managing, 12-lt 
system functions, 14-lt 
tape handling, 15-lt 
DEALLOCATE command, 11-17 
DEAS SIGN/QUEUE command, 9-27 
DEAS SIGN/SYSTEM command, 12-25 

logical name, 12-13 
DECnet/E 

crash analysis, 10-29 
di sabling 

during shutdown, 4-5, 4-7 
logins, 4-4 
EVTLOG 

program, 4-7 
shutdown phase, 4-11 
interrupt shutdown, 4-8 
Network Services Protocol file, 
12-21 

resetting shutdown status, 4-8 

shutdown, 4-7 
example, 4-16 
phase, 4-7 

use of NCP, 4-8 
DECnet/E Network Services 
Protocol 

see NSP 
DECtape Exerciser program 

see DTEXER program 
/DEFAULT qualifier 

INITIALIZE/QUEUE command, 9-32 

SET QUEUE command, 9-38 
Default queues 

Print/Batch Services, 9-4 
DEFINE/COMMAND/SYSTEM command, 

12-14, 12-26 
/DELETABLE qualifier 

SET FILE command, 12-44 
DELETE/ACCOUNT command, 7-13 
DELETE/COMMAND/SYSTEM command, 

12-17, 12-27 
DELETE/QUEUE command, 9-28 
DELETE/SERVER command, 9-29 
Delimiter 

keyboard, 13-7 
/DELIMITER qualifier 

SET TERMINAL command, 8-12 
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/DENSITY qualifier 
BACKUP command, 16-6 
INITIALIZE command, 15-15 
SET SYSTEM command, 14-32 

/DENSITY switch, SAVE/RESTORE, 
E-10 

Description block, run-time 

system, 12-6, 12-8 
DETACH command, 13-9, 13-13 
OPSER, A-17 
QUEMAN, A- 22 
Detached job 

check with SYSTAT, 14-8 
SHOW JOBS/DETACHED command, 
14-8 

Detached-job quota, 5-4 
/DETACHED__JOB__QUOTA qualifier 

CREATE/ACCOUNT command, 7-9 

SET ACCOUNT command, 7-17 
Device designators, F-3t 

table of BATCH, A-57t 
Device management, DCL commands, 

11-lt 
DEVICE privilege 

restricted device, 6-3 
Device sizes, disk type, C-lt 
Device testing package 

definition, F-l 
Device Testing Programs 

see DEVTST programs 
/DEVICEJTYPE qualifier 

SET PRINTER command, 11-24 

SET TERMINAL command, 8-12 
DEVTST programs, F-3t 

conventions, F-2 

error messages, F-5t 

how to run, F-2 
/DFLENGTH switch 

effect on line printer, A-36 

effect on terminals, A-36 

SPOOL, A-35 
Dial-up flag 

account attribute, 7-6 
dial-up line 
ring characteristics, 8-7 

set characteristics, 8-7 
/DIALUP qualifier 

CREATE/ACCOUNT command, 7-9 

SET ACCOUNT command, 7-17 

SET TERMINAL command, 8-12 
Digital Command Language 

see DCL 



Directory 

fragmentation, 1-10 

minimize search overhead, 1-10 

reducing accesses, 11-3 

restructure with REORDR, 11-2 
Directory caching, 11-9 

see also Caching 

cache clusters used, 11-20 

enable on the system, 11-18 

GFD, 11-9 

MFD, 11-9 

optimize, 11-14, 12-18 

overlay code, 11-9 

UFD, 11-9 
Directory structure 

optimizing on disk, 11-3 

prevent a damaged, 11-6 
/D I REC TOR Y__MAX I MUM qualifier 

SET CACHE command, 11-21 
Dirty disk 

rebuilding with MOUNT, 15-19 

when dirty bit is set, 15-16 
/DISABLE qualifier 

SET CACHE command, 11-21 

SET DEVICE command, 11-22 
Disk 

copy to one that contains bad 

blocks, E-l 
copying with IMAGE, E-26 
create bootable system, E-l 
create fast copy, E-l 
differences between Level and 

Level 1, 1-9 
directory entries scattered, 

11-2 

dismount under SHUTUP, 4-12 
formatting with DSKINT option 

of INIT.SYS, 15-2 
free space, 14-8 
IMAGE output as system, E-27 
legal with IMAGE, E-26 
MFD on system, 1-10 
optimizing, 1-10 

directory structure, 11-3 
organization, 1-4 
options, 1-4 
private, 1-5, 1-10 
rebuilding a dirty disk with 

MOUNT, 15-16 
rebuilding with MOUNT command, 

15-19 

reorder disk structure, 11-5 
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Disk ( Cont . ) 

reorder in public structure, 

11-5 
restoring, E-20 
restructure directories, 11-2 
SAVE Set, E-2 

statistics (DISPLY), 14-21 

status statistics, 14-21 

stopping an RC25, 14-2 

system, 1-3, 1-4 

types, 1-4 
Disk characteristics, INITIALIZE 

display, 15-12 
Disk exerciser test 

DSKEXR program, F-10 
Disk handling, DCL commands, 

15-lt 
Disk Quota 

operations, 5-2 
Disk quota 

attribute block, 5-1 

logged-in, 5-2 

logged-out, 5-2, 5-3 
Disk Quotas, 5-1 
Disk quotas, 5-1 
Disk size, disk type, 15-8t 
Disk type, device sizes, C-lt 
Diskette controller test 

DXEXER program, F-16 
DISMOUNT command 

disks, 15-4 

tapes, 15-6 
Display program 

see DISPLY 
DISPLY 

abbreviations in DISPLY report, 
14-18 

account location, 14-9 
buffer status report, 12-20 
busy device statistics, 14-20 
commands, 14-12t to 14-15t 
detached, 14-10 
disk status abbreviations, 
14-22t 

disk structure statistics, 

14-21 
example, 14-16 
free buffers, 14-24 
information displayed, 14-11 
INTERVAL question, 14-9 
job status statistics, 14-18 
memory status, 14-27 



DISPLY 

memory status (Cont.) 

abbreviations, 14-28t 
message receivers, 14-23 

abbreviations, 14-24t 
resident libraries, 14-27 

abbreviations, 14-26t 
restrict use, 14-9 
run-time systems, 14-25 

abbreviations, 14-26t 
running, 14-9 
screen layout, 14-15 
STATE column abbreviations, 

14-19t 
stop execution, 14-11 
switches, 14-10t 
titles used in report, 14-18 
use, 14-7 

WHY column abbreviations, 
14-21t 
DSKEXR program 

disk exerciser test, F-10 

errors, F-12 

example dialogue, F-ll 
DSKSEK program 

data caching restriction, F-13 

error messages, F-13 

example dialogue, F-13 

non- file - structured disks test, 
F-13 
DTEXER program 

error messages, F-15 

example dialogue, F-15 

TC11 DECtape test, F-14 
DUMP/SYSTEM command, 12-22, 12-28 
DXEXER program 

diskette controller test, F-16 

error messages, F-17 

example dialogue, F-16 

-E- 

/EIGHT__BIT qualifier 

SET PRINTER command, 11-24 
SET TERMINAL command, 8-13 

EIS operation test 
CPEXER program, F-6 

EMT 

definition, 14-4 
that cannot be logged, 14-5 
EMT logging, 14-4 

data contained in packet, 14-6 
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EMT logging (Cont.) 

data returned, 14-6 

how to program, 14-5 

packet, 14-6 

reasons for using, 14-4 

shutdown under SHUTUP, 4-12 

system security, 14-7 
/ENABLE qualifier 

SET CACHE command, 11-21 

SET DEVICE command, 11-22 
END command, OPSER, A- 62 
/END qualifier 

BACKUP command, 16-7 

RESTORE command, 16-15 
Entry number, accessing entries, 
9-9 

Entry specification, accessing 

entries, 9-9 
/EOT qualifier 

SET PRINTER command, 11-24 
/ERASE qualifier 

INITIALIZE command, 15-9 
ERR. SYS file 

allocate and position, 12-18 
ERRCPY 

activating, 10-2 

active during time sharing, 
10-2 

error message from SHUTUP, 10-4 
messages queued, 10-4 
minimize size, 10-1 
number of messages queued, 10-1 
processing error messages, 10-4 
shutdown procedures, 4-11 
shutdown under SHUTUP, 4-11 
total errors received, 10-12 
use, 10-2 

ERRORS . FIL 

error logging file, 10-1 

ERRDET 

criteria for bad blocks, 10-9 
report content, 10-9 
ERRDET module 

ERRDIS, 10-5 
ERRDIS 

bad blocks, 10-10 

example, 10-9 

potentially, 10-5 

report, 10-9 
categories of errors, 10-11 
detailed report, 10-4 
dialogue explanations, 10-5t 



ERRDIS ( Cont. ) 

disk error description, 10-16t 
error code mnemonic, 10-11 
error file, zero contents, 10-5 
error sequence number, 10-11 
error title line, 10-11 
full report, 10-11 

examples, 10-12 to 10-25 
functions, 10-4 
modes, optional, 10-5 
modules, 10-5 
nondisk peripheral device 
format, 10-22, 10-23t 
nonperipheral error 

description, 10-24 

format, 10-26t 
running, 10-5 

summary report, 10-4, 10-8 
user description data, 10-12, 
10-13t 

ERRINT 

chains to ERRCPY, 10-3 

change the maximum size, 10-3 

command file, 10-2 

example of dialogue, 10-3, 10-4 

location of program, 10-3 

run, 10-2 

run at start-up, 3-7 

validates error file, 10-1 
ERRLOG . FIL file, 10-2 

stores error messages, 10-1 
Error file 

adding, 12-22 

initialization, 10-2 

removing, 12-22 

SHOW FILE/SYSTEM command, 12-21 
validation, 10-2 
zero, 10-5 
Error logging, 2-7 

creation of file, 10-1 
ERRCPY, 10-4 
hardware errors, 10-1 
initial conditions for system, 
3-7 

initialization, 10-2 
software errors, 10-1 
use of programs, 10-2 
Error messages 
processing, 10-1 
processing with ERRCPY, 10-4 
SAVE/RESTORE, E-42t 

nonfatal transfer, E-50 



Index - 8 



Error messages (Cont.) 

SPOOL, A-49 

syntax, A-39, A-39t 
Error package 

programs in System, 10-1 
Error trap 

infinite loop, 2-7 

two categories, 2-7 

unexpected, 2-7 
/ERROR_FILE qualifier 

SHOW FILE/SYSTEM command, 12-46 
/ERROR_LOGGING qualifier 

INSTALL/LIBRARY command, 12-31 

INS TALL/RUNT I ME__SYSTEM command, 
12-34 

Errors 

catastrophic, 2-3, 2-7 
automatic recovery, 2-7 
causes, 2-7 
handling, 2-7 
categories of reported (ERRCPY), 
10-11 

checking CCL command, 12-15 
detailed report, 10-4 
detection in RSTS/E monitor, 
10-1 

disk (ERRDIS), 10-11 

displaying, 10-4 

example of MSCP in full report 

(ERRDIS), 10-19 to 10-22 
logging, 10-1 
missed (ERRCPY), 10-12 
MSCP in full report (ERRDIS), 

10-19 

nondisk peripheral device, 
10-12 

nonperipheral , 10-11, 10-24 
privileged job programming, 2-6 
recovery from line printer, 
A-47 

SAVE/RESTORE, E-41 
SAVE/RESTORE input volume, 
E-llt 

summary report, 10-4 

summary report (ERRDIS), 10-8 

total received by ERRCPY, 10-12 
/ESCAPEJSEQUENCE qualifier 

SET TERMINAL command, 8-13 
Event logger 

DECnet/E, 4-8 
EVTLOG program 

DECnet/E example, 4-16 



EVTLOG program (Cont.) 

DECnet/E shutdown, 4-7 

resetting shutdown status, 4-8 

shutdown phase, 4-11 
/EXCLUDE qualifier 

BACKUP command, 16-7 

RESTORE command, 16-16 
Execute access 

GREAD privilege, 6-4 

WREAD privilege, 6-9 
Executive 

definition, 1-2 
/EXERCISE qualifier 

INITIALIZE command, 15-10 
Exit status, Batch jobs, 9-16 
/EXPIRE qualifier 

CREATE/ACCOUNT command, 7-9 

SET ACCOUNT command, 7-17 
EXQTA privilege 

logged-in quota, 6-4 

logged-out quota, 6-4 

Print/Batch Services (PBS), 9-7 
Extended buffer pool 

see XB17F 
Extended Instruction Set 

see EIS 

-F- 

FDF 

form characteristics, 9-17 
/FORMS qualifier, 9-17 
Print/Batch Services (PBS), 
9-18 

File 

accounting information, A-48 

add swap file, 12-18 

bad block, 10-10 

bad cluster while transferring 

contiguous, E-21 
caching, 11-14 

contiguous, 11-14 

random mode, 11-11 

sequential mode, 11-11 
cannot remove or add NSP, 12-21 
commands 

start-up, A-17 
directory entries, 11-2 
disk structure, 1-5, 1-10 
high access (definition), 11-15 
minimize access overhead in 
data, 1-10 
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File ( Cont . ) 

Network Services Protocol, 
12-21 

read from sequentially cached, 

11- 11 

remove swap file, 12-18, 12-20 
run request with no file type, 

12- 8 
SIL, 12-9 
structures, 1-5 
swap file, 1-11 
system control, 12-17 

File access 

SYSIO privilege, 6-7 
/FILE qualifier 

SET CACHE command, 11-21 
/FILE_DATA qualifier 

BACKUP command, 16-7 

RESTORE command, 16-16 
/FILE_END qualifier 

STOP/SERVER command, 9-54 
/FILL qualifier 

SET PRINTER command, 11-25 
FIP small buffer 

DISPLY report, 14-24 

use for CCL, 3-9 
FORCE 

CTRL/C, 13-4 

example, 13-5 
FORCE command, 13-4, 13-14 
Form characteristics 

Forms Definition File (FDF), 
9-17 
FORM command 

SPOOL, A-51 
Form length 

line printer, A-36 
FORM option 

SPOOL, A-34 
/FORM_FEED qualifier 

SET TERMINAL command, 8-13 
/FORMAT qualifier 

INITIALIZE command, 15-15 
Formatting 

disks requiring system shutdown, 
15-2 
Forms alignment 

changing, A-51 

during time sharing, A-34 

procedures, A-34 
Forms control, A-35 



Forms Definition File 

see FDF 
/FORMS qualifier 

Forms Definition File (FDF), 
9-17 

INITIALIZE/QUEUE command, 9-3! 
INITIALIZE/SERVER command, 9-i 
SET QUEUE command, 9-39 
SET SERVER command, 9-42 

/FORWARDSPACE qualifier 

START/QUEUE/MANAGER command, 
9-50 

FPP test 

CPEXER program, F-6 

/FULL qualifier 

SHOW ACCOUNT command, 7-23 
SHOW SERVER command, 9-45 
SHOW TERMINAL command, 8-20 

■G- 

GACNT privilege 

account management, 6-4, 6-9 
General small buffer 

DISPLY report, 14-24 

missed errors, 10-12 

SPOOL error, A-40 

use for CCL, 3-9 
GFD (Group File Directory) 

with MFD and UFDs in Level 1, 
l-8f 
GREAD privilege 

execute access, 6-4 

read access, 6-4 
/GROUP_SIZE qualifier 

BACKUP command, 16-7 
GWRITE privilege 

create access, 6-4 

rename access, 6-4 

write access, 6-4 

-H- 

HANGUP command, 13-9, 13-15 
/HANGUP qualifier 

SET SYSTEM command, 14-33 
/HARDCOPY qualifier 

SET TERMINAL command, 8-13 
Hardware 

malfunctions, 2-6 
Hardware controller 

terminal device designator, 8 
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Hardware errors 

logging, 10-1 
/HEADER qualifier 

BROADCAST command, 13-12 
Heading burst pages, A-34 
HELLO command, CCL, 3-9 
Help report 

ERRDIS (example), 10-7 
/HOLD qualifier 

SET JOB command, 13-20 

SET SYSTEM command, 14-33 
HOLD state 

processing entries, 9-8 
/HOSTSYNC qualifier 

SET TERMINAL command, 8-13 
HWCFG privilege 

SET TERMINAL command, 8-4 

system manager function, 6-4 

terminal characteristics, 8-4 
HWCTL privilege 

system control, 6-5 

-I- 

IDENTIFY, E-4t 
dialogue, E-32t 
example, E-33 

IMAGE, E-4t 

dialogue, E-27t 
example, E-29 to E-32 
extracting pack ID, E-32t 
output from, as system disk, 
E-27 

run statistics, E-40 

SAVE/RESTORE, E-26 
Immediate mode 

shutting down OPSER, 4-10 
/IN_LABEL qualifier 

BACKUP command, 16-8 

RESTORE command, 16-16 
/IN_QUOTA qualifier 

CREATE/ACCOUNT command, 7-9 

SET ACCOUNT command, 7-17 
/INCLUDE qualifier 

BACKUP command, 16-8 

RESTORE command, 16-16 
/INDEX qualifier 

INITIALIZE command, 15-10 
Indexed file 

caching, 11-14 
INIT 

command, 2-7 



INIT (Cont . ) 

start OPSER, A-17 
INIT.BAS program 

OPSER shutdown conditions, 4-10 
INIT. SYS file 

copies to disk, E-34 

SAVE/RESTORE tape, E-9 
INIT. SYS program 

control file, 3-1 

DSKINT option to format disks, 
15-2 

use, 2-1 
Initialization code 

bootstrapped, 2-1 

RSTS/E, 2-2 

START option, 3-1 
Initialization options 

discussion, 1-4 

requesting, 2-3 

summary, 2-3t 
INITIALIZE command 

/DENSITY qualifier, 15-15 

disks, 15-7 to 15-13 

display of disk characteristics, 
15-12 

/FORMAT qualifier, 15-15 

QUEMAN, A- 21 

tapes, 15-14 
/INITIALIZE qualifier 

BACKUP command, 16-8 

RESTORE command, 16-16 
INITIALIZE/QUEUE command, 9-30 
INITIALIZE/SERVER command, 9-34 
Initializing disks 

INITIALIZE command, 15-7 to 
15-13 

overview, 15-2 
Initializing tapes 

INITIALIZE command, 15-14 

overview, 15-2 
/INQUIRE qualifier 

SET TERMINAL command, 8-14 
INSTAL privilege 

defining CCLs, 12-14 

system commands, 6-5 

system files, 6-5 

system logical names, 6-5 
INSTALL/ERROR_FILE command, 12-22, 
12-29 

INSTALL/ERRORFILE command, 12-18 
INSTALL/LIBRARY 

DCL command, 12-10, 12-11 
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INSTALL/LIBRARY ( Cont . ) 
/LOCK qualifier, 12-11 
/[ NO] ADDRESS [=n] qualifier, 
12-10 

INSTALL/LIBRARY command, 12-30 
INSTALL/OVERLAY_FILE command, 

12-18, 12-21, 12-32 
INSTALL/RUNTIME_SYSTEM 

/ADDRESS=n qualifier, 12-6 
/LOCK qualifier, 12-8 
/MAXIMUM=s qualifier, 12-8 
/MINIMUM=s qualifier, 12-8 
/[NO]ERROR_LOGGING qualifier, 
12-6 

/ [ NO ] KEYBOARD_MONI TOR qualifier, 
12-6 

/ [ NO ] READ__ONL Y qualifier, 12-6 
/[NO] SHAREABLE qualifier, 12-6 
/[NO ] UNLOAD qualifier, 12-6 
/POSITION qualifier, 12-7 
/PREFIX=n qualifier, 12-6 

INSTALL/RUNTIME_SYSTEM command, 
3-8, 12-5, 12-6, 12-33 
errors, 12-7 

INSTALL/RUNTIME_SYSYTEM 
/TYPE qualifier, 12-8 

INSTALL/SWAP__FILE 
errors, 12-20 
/SIZE=n qualifier, 12-19 

INSTALL/SWAP_FILE command, 12-18, 
12-36, 13-3 

/INTERACTIVE qualifier 

CREATE/ACCOUNT command, 7-10 
SET ACCOUNT command, 7-17 
SET TERMINAL command, 8-14 

INTERRUPT command 

OPSER, A-15, A-16, A-23t, A-61 
response to, A-16 

Interrupt commands 
BATCH, A-56t 
SPOOL, A-41 

-J- 

Job 

accounting information, A-48 
check detached, 14-8 
check number of, 14-9 
compute bound, 13-8 
definition, 1-2 

executing a read request, 11-9 
header, A-48 



Job ( Cont . ) 

keyboard monitor, 1-2 
limit of spooling, A-28 
maximum (JOB MAX), 12-20 
maximum assigned size, 13-8 
number allowed, 12-20 
OPSER checks online, A-7 
OPSER table, A- 2 
priority, 13-8 
run burst, A-44 
set maximum size, 13-6 
setting priority, 13-6 
status statistics, 14-18 
suspend, 13-6 

Job area 
size, 1-11 
user, 1-11 

Job control 

SHOW USER command, 13-6 

JOB MAX 

restricts jobs, 12-20 

/JOB qualifier 

ALLOCATE command , 11-16 

Job quota, 5-4 

detached- job, 5-4 
log-in request, 5-5 

Job quotas, 5-1 

Job run burst, 13-7 

Job status, SYSTAT, 14-8 

Job table, SHUTUP, 4-8 

/JOB__END qualifier 

STOP/SERVER command, 9-54 

/JOB_QUOTA qualifier 

CREATE/ACCOUNT command, 7-10 
SET ACCOUNT command, 7-17 

JOBCTL privilege 

system control, 6-5 

-K- 

/KATAKANA qualifier 

SET TERMINAL command, 8-14 

KBEXER program 

errors, explanation, F-18 
example dialogue, F-18 
local terminals test, F-17 
remote terminals test, F-17 
terminal tests, F-17 

/KEBOARD_MONITOR qualifier 
SET JOB command, 13-20 

/KEEP qualifier 

SET CACHE command, 11-21 
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/KEEP=n qualifier 

minimum residency time, 11-15 
Keyboard 

controlling, 13-9 

default SPOOL values, A-38 

delimiter, 13-7 

monitor, 1-11 

spooling, A-38 

start-up on LA180, A-46 

start-up on LA36, A-45 
Keyboard monitor, 3-9 

change with SWITCH, 1-2 

default (definition), 1-2 

definition, 1-2 

job, 1-2 

process command, 1-10 
/KEYBOARD_MONITOR qualifier 

INS TALL/RUNT I ME_SYSTEM command, 
12-34 

KILL 

UTILTY program, A-63 
-L- 

LA180 

form length, A-36 

start-up keyboard on, A-46 
LA36 

start-up keyboard on, A-45 
/LABEL qualifier 

SET SYSTEM command, 14-33 
Label, specified for tapes 

DISMOUNT command, 15-6 

INITIALIZE command, 15-14 

MOUNT command, 15-23 
Level 0, l-7f 

compared to Level 1, 1-9 
Level 1 

compared to Level 0, 1-9 

three structures involved, 1-8 
Library 

remove resident, 12-11 

resident, 12-9 
LIBRARY keyword, 12-10 
Line printer 

default SPOOL values, A- 37 

/DFLENGTH switch effect, A-36 

distinction from terminal, A-37 

form length, A-36 

output, A-48 

recovery from errors, A-47 
requests for output, A-6 



Line printer (Cont.) 

spooling, A-29, A-37 

start-up 

all defaults, A-42 
narrow width, A-43 
Line printer test 

LPEXER program, F-18 
/LINE_NUMBER qualifier 

DEFINE/COMMAND/SYSTEM command, 
12-26 
LIST command 

OPSER, A-16 
LIST JOBS command 

OPSER, A-16, A-61 
LIST OPERATORS command 

OPSER, A-16 
/LIST_FILE qualifier 

BACKUP command, 16-9 

RESTORE command, 16-17 
Load address 

run-time system, 12-6 
LOAD/OVERLAY command, 14-29 
/LOADABLE_CHARACTERS qualifier 

SET TERMINAL command, 8-14 
Local terminal test 

KBEXER program, F-17 
/LOCAL_ECHO qualifier 

SET TERMINAL command, 8-14 
/LOCK qualifier 

INSTALL/LIBRARY command, 12-31 

INSTALL/RUNTIME__SYSTEM command, 
12-34 
/LOG qualifier 

CREATE/ACCOUNT command, 7-10 

DELETE/ACCOUNT command, 7-13 

SET ACCOUNT command, 7-18 

SET FILE command, 12-44 

SET PASSWORD command, 7-21 
LOGFILE command 

OPSER, A-17 
Logged-in quota, 5-2 

EXQTA privilege, 6-4 
Logged-out quota, 5-2, 5-3 

EXQTA privilege, 6-4 
/LOGGED_IN qualifier 

BROADCAST command, 13-12 

FORCE command, 13-14 
Logical device 

BATCH, A- 52 

SPOOL, A-30 
Logical end mode 

shutdown of OPSER, 4-10 
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Logical name 

account number associated, 
12-12 

adding new, 12-13 

ASSIGN/SYSTEM command, 12-13 

DEAS SIGN/SYSTEM command, 12-13 

job related, 12-11 

list, 12-14 

system, 12-11 

system defined, 12-12 

unique, 12-12 
Logical Names 

managing with DCL commands, 
12-lt 

LOGIN 

set priority, 13-7 
LOGIN command, 13-16 
Login command file 

LOGIN.COM, 6-11 
LOGIN. COM 

login command file, 6-11 
Logins 

decrease the number of, 12-20 
limit, 13-2 

limit for DECnet/E, 4-5 
limit under SHUTUP, 4-5 
limiting, in SHUTUP, 4-5 
restrict, 13-2 

restricted by swap space, 12-20 
swap file space affects, 12-20 
SWCTL privilege, 6-7 

/LOGINS qualifier 

SET SYSTEM command, 13-21 

LOGOUT command, 13-16 

/LOOKUP qualifier 

CREATE/ACCOUNT command, 7-10 
SET ACCOUNT command, 7-18 

/LOWERCASE qualifier 

SET PRINTER command, 11-25 
SET TERMINAL command, 8-15 

LPEXER program 

errors, explanation, F-19 
example dialogue, F-19 
line printer test, F-18 

-M- 

Magnetic tape 

density for Save Set, E-37 
/DENSITY switch, E-10 
lowest density allowed, E-9 
SAVE Set, E-2, E-36 



Magnetic tape (Cont.) 

SAVE/RESTORE requirements, E-9 
valid medium (SAVE/RESTORE), 
E-9 

Magnetic tape exerciser 

See MTEXER program 
MAKSIL program 

formats disk file, 12-9 
Management 

RSTS/E system, 1-3 
Mass Storage Control Protocol 

see MSCP 
Master File Directory 

see MFD 
/MAXIMUM qualifier 

SET CACHE command, 11-21 
/MAXIMUM_SIZE qualifier 

INSTALL/RUNTIME_SYSTEM command, 
12-34 

Memory 

adding resident library, 12-11 
available range of, 12-7 
avoiding fragmentation, 12-6 
dump, 10-27 
fragmentation, 12-7 
high, 12-7 
low, 12-7 

status statistics, 14-27 
Memory access 

data caching, 11-9 
Memory dump 

annotated version, 10-29 

critical contents, 10-29 
MESSAGE command 

OPSER, A-13, A-17 
Message quota, 5-5 
Message receiver 

OPSER, A-2 

QUEMAN declares self, A-20 
Message receivers 

abbreviations (DISPLY), 14-24 

statistics (DISPLY), 14-23 
/ME S SAGE_QUOTA qualifier 

CREATE/ACCOUNT command, 7-10 

SET ACCOUNT command, 7-18 
Messages 

% characters, D-l 

? characters, D-l 

general, D-l, D-2t to D-49t 

informational, D-2 

severe error, D-l 

standard error, D-l 
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Messages ( Cont . ) 
warning, D-l 

MFD (Master File Directory) 
and UFDs in Level 0, l-7f 
with GFDs and UFDs in Level 1, 
l-8f 

/MFD__CLUSTER_SIZE qualifier 

INITIALIZE command, 15-11 
Micro/RSTS spooler 

see also SPL 
/MINIMUM_SIZE qualifier 

INS TALL/RUNT I ME_SYSTEM command, 
12-34 
Missed errors 

reported to ERRCPY, 10-12 
MODE values 

data caching, 11-9 
/MODIFIED qualifier 

BACKUP command, 16-5 

RESTORE command, 16-15 
Moni tor 

caching checks, ll-19f 

control of run-time system, 
12-4 

default keyboard, 1-2 
definition, 1-2 

directives (data caching), 11-9 
error detection, 10-1 
job keyboard, 1-2 
keyboard, 1-2 
symbols (list), 10-29 
take online dump, 12-22 
update cache, 11-10 
MOUNT command (disks), 15-16 
/[NO]QUOTA qualifier, 15-19 
/[ NO ] REBUILD qualifier, 15-19 
/[ NO ] RESTRICT qualifier, 15-21 
/[ NO ] SHARE qualifier, 15-18t, 
15-21 

/[ NO ] WRITE qualifier, 15-22 
/PRIVATE qualifier, 15-17, 
15-18t 

/PUBLIC qualifier, 15-17, 
15-18t 

MOUNT command (tapes), 15-23 
/DENSITY qualifier, 15-24 
/FORMAT qualifier, 15-24 
/[NO]WRITE qualifier, 15-25 

MOUNT privilege 

public disk, 15-16 
shared disks, 6-5 



Mounting disks 

DISMOUNT (disks), 15-4 

MOUNT command (disks), 15-16 to 
15-22 

overview, 15-3 
Mounting tapes 

DISMOUNT (tapes), 15-6 

MOUNT (tapes), 15-23 

overview, 15-3 
MSCP 

ERRDIS full report, 10-19 
example, 10-19 to 10-22 
MTEXER program 

error messages, F-20 
example dialogue, F-20 
magnetic tape controllers test, 
F-19 

magnetic tape drives test, F-19 



-N- 

NAME option 
SPOOL, A-34 

/NAME qualifier 

CREATE/ACCOUNT command, 7-10 
SET ACCOUNT command, 7-18 
SET SYSTEM command, 14-33 

NCP 

network shutdown, 4-8 
Network 

shutdown of DECnet/E, 4-7 
Network Control Program 

see NCP 
Network management 

SWCTL privilege, 6-7 
/NETWORK qualifier 

CREATE/ACCOUNT command, 7-10 

SET ACCOUNT command, 7-18 
Network Services Protocol 

see NSP 
/NETWORK_FILE qualifier 

SHOW FILE/SYSTEM command, 12-46 
NEXT command 

error in, A-26 

error text, A-26t 

QUEMAN, A-26 
/NEXT_JOB qualifier 

START/QUEUE/MANAGER command, 
9-50 

/NOBROADCAST qualifier, prevents 
receiving broadcasts, 8-7 
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/NOCONTIGUOUS qualifier 

SET FILE command, 12-44 
Non- file - structure disk test 

DSKSEK program, F-13 
Non- file - structured I/O 

RDNFS privilege, 6-5 

WRTNFS privilege, 6-9 
Nonuser account, 7-2 
NORMAL option 

changing in SPOOL, A-34 

SPOOL, A-34 
NSP (Network Services Protocol) 

cannot remove or add, 12-21 
Number conversion, bit position, 
B-l 

-0- 

/OCCURRENCE qualifier 

RESTORE command, 16-17 
Octal Debugging Tool 

see ODT 
ODT (Octal Debugging Tool) 

setting breakpoints with, 12-6 
/OMIT_CR qualifier 

SET PRINTER command, 11-25 
ONLCLN 

perform disk cleaning, E-ll 
OPEN/QUEUE command, 9-36 
Operating system 

definition, 1-2 
OPERATOR command 

OPSER, A-17 
Operator communication program, 
A-58 

Operator services 

BATCH, A- 2 

flowchart, A-4f 

OPSER, A-2, A-7 

overview, A-2 

QUE MAN , A-2 

RESTOR, A-2 

SPOOL, A-2 
Operator Services Console 

see OSC 
Operator table 

OPSER, A-8 
OPSER 

ABORT command, A- 63 

action requests, A-13 
contents, A-14t 

ANSWER command, A- 15 



OPSER (Cont . ) 

cause INIT to start, A-17 
CHANGECONSOLE command, A-17 
changes OSC, A-18 
checks for on line jobs, A-4, 
A-8 

checks operator table, A-8 
commands 

from PLEASE, A-60t 

from SHUTUP, A-61 

START.COM, A-17 
communicates 

three ways, A-5 

with BATCH, A- 55 
communicates with SHUTUP, 4-3 
controlled program, A-2 
controlling RESTOR, A-7, A-63 
DETACH command, A-17 
END command, A- 62 
immediate shutdown mode, 4-10 
initial operating conditions 

for, A-17 
interaction with action request, 
A-5 

interaction with information 

line, A-5 
interaction with message, A-5 
INTERRUPT command, A- 15, A- 16, 

A-23t, A-61 
LIST command, A-16 
LIST JOBS command, A-16, A-61 
LIST OPERATORS command, A-16 
LOGFILE command, A-17 
logical end mode, 4-10 
message 

contents, A-14t 

formats, A-14 

levels, A-15 

receiver identification, A-2 
MESSAGE command, A-13, A-17 
online job list, A-16t 
OPERATOR command, A-17 
operator commands, A-lOt 
operator communicate with, A- 59 
operator table, A-8 
overview, A-2 
RESTOR commands, A-63t 
restrictions of, A-2 
RETYPE command, A-13 
running with SHUTUP, 4-3 
send command to QUEMAN, A- 25 
shutdown, A-7 
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OPSER (Cont.) 

shutdown in SHUTUP, 4-10 
shutdown procedures, 4-10 
start after system crash, A-18 
start-up procedure, A-17, A-18 
starting, A-8 
table of online jobs, A-2 
terminating with SHUTUP, A-7, 
A-61 

valid operators, A-16, A-61 

ways terminated, A-18 

work file, A-8 
OPSER package 

BATCH, A- 52 
OPSER Package Library 

QUEMAN, A- 19 
OPSER . LOG file 

default log file, A-9 
/OPTIMIZE qualifier 

RESTORE command, 16-17 
Options 

INIT program, 2-7 
OSC (Operator Services Console) 

INTERRUPT responses, A-16 

OPSER broadcasts messages to, 
A-3 

OPSER changes, A-18 

output formats, A-14 

send text to, A-58 
/OUT_LABEL qualifier 

BACKUP command, 16-9 

RESTORE command, 16-18 
/OUT_QUOTA qualifier 

CREATE/ACCOUNT command, 7-11 
OUT_QUOTA qualifier 

SET ACCOUNT command, 7-18 
/OUTPUT qualifier 

SHOW ACCOUNT command, 7-23 
Overlay file 

adding, 12-21 

removing, 12-22 

SHOW FILE/SYSTEM command, 12-21 
/OVERLAY_FILE qualifier 

SHOW FILE/SYSTEM command, 12-46 
/OVERRIDE qualifier 

LOGIN command, 13-17 
OVR.SYS file 

allocate and position, 12-18 



.p. 

Pack identification 

extracting with SAVE/RESTORE, 
E-32t 
/PAGE qualifier 

START/QUEUE/MANAGER command, 
9-50 

/PAGEJEJECT switch 

SPOOL, A-35 
/PAGE_END qualifier 

STOP/SERVER command, 9-54 
/PAGE_LENGTH qualifier 

SET PRINTER command, 11-25 
/PAGE__L I M I T qualifier 

INITIALIZE/QUEUE command, 9-32 

SET QUEUE command, 9-39 
Paper tape punch test 

PPEXER program, F-21 
Paper tape reader test 

PREXER program, F-22 
/PARITY qualifier 

SET TERMINAL command, 8-15 
/PASSWORD_PROMPT qualifier 

CREATE/ACCOUNT command, 7-11 

SET ACCOUNT command, 7-18 

SET SYSTEM command, 14-33 
Patch kits 

see Update kits 
Patches 

see also Updates 
PBS 

batch servers, 9-3 
default queues, 9-4 
Forms Definition File (FDF), 
9-18 

print servers, 9-3, 9-10 

queue manager, 9-3 

queue names, 9-4 

queue priorities, 9-6 

queue types, 9-4 

treatment by SHUTUP, 4-8 

user interface, 9-3 
PBSCTL privilege 

Print/Batch Services (PBS), 6-5 
PDP-11 word 

decimal values, B-l 

octal values, B-l 
PEEK function test 

CPEXER program, F-6 
/PERMANENT qualifier 

SET TERMINAL command, 8-7, 8-15 
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/PERMANENT qualifier (Cont.) 

SHOW TERMINAL command, 8-20 
Physical device names, 12-11 
PHYSICAL option 

SPOOL, A-33 
/PLACED qualifier 

SET FILE command, 12-44 
/PLACED_POSITION qualifier 

RESTORE command, 16-18 
.PLAS system directive 

RDMEM privilege, 6-5 
PLEASE 

CCL command, A-61 

commands through OPSER, A-60t 

commands to OPSER, A- 59 

message broadcast, A-59 

OPSER commands through, A-59 

restrict use, A-58 

run, A-58 

talks to OPSER, A-3 
terminate, A-58 
/POSITION qualifier 

CREATE/ACCOUNT command, 7-11 
INSTALL/ERROR_FILE command, 
12-29 

INSTALL/OVERLAY_FILE command, 
12-32 

INS TALL/RUNT I ME__SYSTEM command, 
12-34 

INSTALL/SWAP_FILE command, 
12-37 
Power fail 

automatic restart after, 2-8 
/P OWE R FA I L__D E LAY qualifier 

SET SYSTEM command, 14-33 
PPEXER program 

errors, explanation, F-21 

example dialogue, F-21 

paper tape punch test, F-21 
/PREFIX qualifier 

INSTALL/RUNTIME_SYSTEM command, 
12-34 
PREXER program 

error messages, F-22 

example dialogue, F-22 

paper tape reader test, F-22 
Primary run-time system, 12-4 

position, 12-7 

system disk, 1-5 
/PRINT qualifier 

INITIALIZE/QUEUE command, 9-32 

SET QUEUE command, 9-39 



/PRINT qualifier (Cont.) 
SET SERVER command, 9-42 
SHOW SERVER command, 9-45 

Print servers 

Print/Batch Services (PBS), 9-3, 
9-10 

wildcard names, 9-10 
Print/Batch Service (PBS) 

ASSIGN/QUEUE command, 9-25 

INITIALIZE/QUEUE command, 9-30 
Print/Batch Services 

see PBS 

PBSCTL privilege, 6-5 
Print/Batch Services (PBS) 
CLOSE/QUEUE command, 9-26 
DEAS SIGN/QUEUE command, 9-27 
DELETE/QUEUE command, 9-28 
DELETE/SERVER command, 9-29 
INITIALIZE/SERVER command, 9-34 
many-to-one configuration, 9-6 
one-to-many configuration, 9-5 
one-to-one configuration, 9-5f 
OPEN/QUEUE command, 9-36 
SET QUEUE command, 9-37 
SET SERVER command, 9-41 
START/QUEUE command, 9-46 
START/QUEUE/MANAGER command, 
9-47 

START/SERVER command, 9-49 
STOP QUEUE command, 9-51 
S TOP/QUEUE/MANAGER c ommand , 
9-52 

Print/Batch services (PBS) 

STOP/SERVER command, 9-53 
Print/Batch Services Package 
(PBS) 

DCL commands, 9 -It 

managing, 9-3 to 9-16 
Printer servers 

ownership, 9-10 
/PRINTER_JPORT qualifier 

SET TERMINAL command, 8-15 
Printing device 

adjustable top of form, A-36 
Priority 

basis, 13-7 

byte, 13-7 

format, 13-7f 

decrease for job, 13-8 

description, 13-6 

LOGIN, 13-8 

processing entries, 9-8 
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Priority ( Cont . ) 

raise for SPOOL, A-44 
setting job, 13-6 

/PRIORITY qualifier 

INITIALIZE/QUEUE command, 9-33 
INITIALIZE/SERVER command, 9-35 
SET JOB command, 13-20 
SET QUEUE command, 9-39 
SET SERVER command, 9-42 
START/QUEUE/MANAGER command, 
9-48 

/PRIORITY switch 

QUEMAN, A-22t 
Private disk, 1-5, 1-10 
/PRIVATE qualifier 

INITIALIZE command, 15-11 
Privilege 

controlled access, 1-11 

system damage, 1-11 
Privilege mask 

authorized, 6-10 

current, 6-10 

saved, 6-10 
/PRIVILEGE qualifier 

CREATE/ACCOUNT command, 7-11 

SET ACCOUNT command, 7-19 

SET JOB command, 13-20 
Privileged job 

programming error, 2-6 
/PRIVILEGES qualifier 

DEFINE/COMMAND/SYSTEM command, 
12-26 

INITIALIZE/QUEUE command, 9-33 

SET QUEUE command, 9-40 
Processing entries 

AFTER state, 9-8 

HOLD state, 9-8 

priority, 9-8 

READY state, 9-8 
Program 

system, 1-3 
Program development, 1-3 
Programming errors 

causing crash, 2-6 
/PROMPT qualifier 

BACKUP command, 16-9 

RESTORE command, 16-19 
/PROTECTION qualifier 

INSTALL/LIBRARY command, 12-31 

SET FILE command, 12-44 
Pseudo keyboard 

BATCH, A- 52 



Pseudo keyboard (Cont.) 

use with BATCH, A-6 
Pseudo keyboards 

batch servers, 9-15 
Public disk structure, 1-4 
/PUBLIC qualifier 

DISMOUNT command, 15-5 

INITIALIZE command, 15-11 
Public structure, 1-3 
/PURGE qualifier 

DELETE/ACCOUNT command, 7-14 

-Q- 

QUE, A-5 
QUE command 

SPOOL, A-48 
QUEMAN 

command received through OPSER, 

A-25 
commands 

start-up, A-26 
consistency checks, A-21, A-27 
DETACH command, A- 22 
do not CTRL/C, A-23 
entry in AFTER queue, A- 28 
error in NEXT command, A-26 
initial conditions for spooling 

queues, A-21 
INITIALIZE command, A-22 
integrity checks, A-21 
message receiver declaration, 

A-20 
modules, A-19 

OPSER Package Library, A-19 
requirements for running, A-19 
resets to initial states, A-27 
running 

after SHUTUP, A-27 

after system crash, A-27 
running detached, A-22, A-26 
start, A-19 
start-up 

command file, A-26 

commands, A-21t 

switches, A-22t 
STATUS command, A-25 
status printout, A-25 
table of online spooling 
programs, A-5 
/QUERY qualifier 

BACKUP command, 16-10 
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/QUERY qualifier (Cont.) 

DELETE/ACCOUNT command, 7-14 

INITIALIZE command, 15-12 

RESTORE command, 16-19 
Queue limits, 9-9 
Queue management, A-19 
Queue manager 

Print/Batch Services (PBS), 9-3 
Queue names 

Print/Batch Services (PBS), 9-4 
Queue priorities 

Print/Batch Services (PBS), 9-6 
Queue types 

Print/Batch Services (PBS), 9-4 
QUEUE. SYS file, A-5 

clear all entries from, A-21 

consistency checking on, A-27 

corrupt, A-23 

flag value, A-21 

initial conditions, A-21 

number of queue requests, A-27 
Queues 

starting, 9-7 

stopping, 9-7 
Quota 

message, 5-5 

RIB (Receiver ID Block), 5-5 
Quotas 

Disk, 5-1 
Job, 5-1 

send/receive, 5-1 



-R- 



Random data caching, 11-10, 11-11 
RC25 

stopping, 14-2 
RDMEM privilege 

memory mapping, 6-5 

read memory, 6-5 
RDNFS privilege 

non- file - structured I/O, 6-5 
RDS (RSTS/E Disk Structure) 

levels, 1-5 

SYSTAT, 1-6 
Read access 

GREAD privilege, 6-4 

WREAD privilege, 6-9 
/READ_ONLY qualifier 

INSTALL/LIBRARY command, 12-31 

INS TALL/RUNT I ME__SYSTEM command, 
12-34 



READY state 

processing entries, 9-8 
Rebuilding dirty disks with MOUNT, 
15-19 

Receiver identification, A-34 
/REGIS qualifier 

SET TERMINAL command, 8-15 
/RELEASE qualifier 

SET JOB command, 13-20 

SET SYSTEM command, 14-33 
Remote line, controlling, 13-9 
Remote terminal test 

KBEXER program, F-17 
REMOVE/ERROR__FILE command, 12-22, 
12-38 

REMOVE/JOB command, 13-18 

example, 13-5 
REMOVE/LIBRARY command, 12-39 
REMOVE/OVERLAY_FILE command, 

12-22, 12-40 
REMOVE/RUNT I ME_S YS TEM command, 

12-9, 12-41 
REMOVE/SWAP__FILE command, 12-20, 

12-42 
Rename access 

GWRITE privilege, 6-4 
WWRITE privilege, 6-10 
REORDR 

account designators, 11-5 

dialogue, 11-3 
questions, ll-4t 

directory restructuring 
functions, 11-3 

error messages, 11-6 

example, 11-8 

fatal errors, 11-7 

messages, ll-7t 

precautions on use, 11-6 

processing messages, 11-6 

restructure directories, 11-2 

run, 11-3 
/REPLACE qualifier 

ASSIGN/SYSTEM command, 12-24 

RESTORE command, 16-19 
REQUE command 

SPOOL, A-48 
/RESET qualifier 

DELETE/ACCOUNT command, 7-14 

SET TERMINAL command, 8-15 

SHOW ACCOUNT command, 7-23 
Resident libraries 

DISPLY program status, 14-27 
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Resident library, 12-10 
memory location, 12-10 
permanently resident, 12-11 
remove, 12-11 
removing 

under SHUTUP, 4-12 
RMS, 11-14 

XBUF allocation, 11-14 
RESTART command 

SPOOL, A-48 
/RESTART qualifier 

S TART/QUEUE/MANAGER c ommand , 
9-50 

RESTOR 

attached to a terminal, A-63 
commands through OPSER, A-63t 
running detached, A-7, A-64 
RESTORE, E-4t 
aborting, E-38 
bad blocks, E-20 
dialogue questions, E-21t 
example, E-23 to E-26 
output used for system disk, 
E-23 

relocation of blocks, E-21 

restoring a RSTS/E disk, E-20 

run statistics, E-40 

SAVE Set format, E-2 
RESTORE command, 16-12 to 16-21 

quick reference table, 16-21t 

restrictions, 16-21 
/RESTRICT qualifier 

SET DEVICE command, 11-22 

SET TERMINAL command, 8-16 
Restricted device 

DEVICE privilege, 6-3 
Restricted receiver 

SEND privilege, 6-6 
Restrictions 

Backup sets, 16-10 

RESTORE command, 16-21 
/RESUME qualifier 

SET TERMINAL command, 8-16 
/RETAIN qualifier 

INITIALIZE command, 15-13 
Retrieval pointers 

information for data blocks, 
11-3 

RETYPE command, OPSER, A- 13 

/REWIND qualifier 

BACKUP command, 16-10 
RESTORE command, 16-20 



RIB (Receiver ID Block), 6-5 

quota, 5-5 
/RIB_QUOTA qualifier 

CREATE/ACCOUNT command, 7-11 

SET ACCOUNT command, 7-19 
Ring characteristics, 8-2 
RJ2780 program 

communication paths, A-7 

shutdown, A-7 
RMS (Record Management System) 

caching files, 11-14 

indexed file bucket sizes, 
11-14 

resident library, 11-14 
RSTS/E 

bootstrapping after system halt, 
2-3 

bootstrapping procedures, 2-2 
disk structures, 1-4 
file structure, 1-5 
halting, 2-1 

initialization code, 2-1 

initialization options, 2-1 

management, 1-3 

monitor error detection, 10-1 

run-time systems, 12-4 

shutdown procedures, 4-2 

starting up, 2-1 
RSTS/E disk structure 

see RDS 
RSTS/E Error Package 

use with DEVTST package, F-l 
RSTS/E Privileges, 6-3t 
RSX, keyboard monitor, 1-2 
RTll, keyboard monitor, 1-2 
Run burst 

decrease, A-44 

default value, 13-8 

definition, 13-8 

raise on SPOOL, A-44 

set, 13-6 

system operation, 13-8 
RUN command 

how system treats, 12-8 

no file type specified, 12-8 
Run- time system, 1-3 

auxiliary, 12-4, 12-5 

BASIC -PLUS, 12-4 

change default file type, 12-8 

control, 12-4, 12-5 

DCL command, 12-6 

definition, 12-4 
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Run-time system (Cont.) 
description block, 12-6 
DISPLY report, 14-25 
installing, 3-8 
language interface, 12-4 
loading a, 12-7 
permanently resident, 12-8 
placement of, 12-7 
position of primary, 12-7 
primary, 1-3, 12-4 
removing 

auxiliary, 12-6 

from system, 12-9 

under SHUTUP, 4-12 
. RTS file type, 12-5 
specifying load address, 12-6 
storage of, 12-5 
temporarily resident, 12-8 
use, 12-4 
/RUNJ3URST qualifier 

INITIALIZE/SERVER command, 9-35 
SET JOB command, 13-20 
SET SERVER command, 9-42 
START/QUEUE/MANAGER command, 
9-48 

/RUNBURST switch 

QUEMAN, A-22t 
/RUNTIME_SYSTEM qualifier 

SET FILE command, 12-44 

-S- 

SATT.SYS file 

SAVE/RESTORE tape, E-9 
SAV/RES 

full function command line, 
E-34 

SAV/RES FUNCTION 

prompt, E-2, E-4 
SAVE 

requirements of disk devices, 
E-8 

run statistics, E-40 
Save Image Library 
see SIL 
SAVE Set, E-20 

default name, E-2 

dismount message, E-37 

extract label information from, 

E-32t 
format, E-2, E-20 
identify, E-2 



SAVE Set (Cont. ) 

magnetic tape, E-36 
magnetic tape density, E-37 
processing multi -volume , E-36 
recreate disk, E-20 
requirements, E-8 
volume, E-8 

booting RSTS/E, E-35t 

by-pass label checking, E-10 

SAVE/RESTORE, E-2 
SAVE/RESTORE 

bad blocks, E-l 

output device, E-41 

processing, E-41 
changes caused by bad blocks, 

E-42 
checking 

input volume, E-10 

output volume, E-12 
comparison with BACKUP, E-l 
create bootable medium, E-l, 
E-34 

CTRL/C in dialogue, E-8, E-38 
CTRL/Z in dialogue, E-8 
definition of terms, E-2 
device specification switches, 

E-lOt 
dialogue, E-3 

defaults, E-7 
disks, like, E-2 
dismount message, E-37 
dismounting volumes, E-36 
error messages, E-12 
/ERROR switch, E-6, E-6t 
errors, E-5 

dialogue, E-41 

handling, E-41 

messages , E - 42t 

transfer phase, E-41 

verification phase, E-41 
exit, E-3 

/EXPIRATION switch, E-6, E-6t 
fatal transfer errors, E-49 
full function command line, E-6 
function response, E-4 
functions, E-l, E-4t 
IDENTIFY 

dialogue, E-32t 

example, E-33 
IMAGE 

dialogue, E-27t 

example, E-29 to E-32 
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SAVE/RESTORE 
IMAGE (Cont.) 

function, E-26 
input volume errors, E-llt 
long form dialogue, E-7 
magnetic tape, E-9 
message types, E-5 
mounting volumes, E-36 
/NOERROR switch, E-6t, E-42, 
E-49 

/NOEXPIRATION switch, E-6t 
nonfatal transfer errors, E-49, 
E-50t 

nonselective backup, E-l 
/NO STATS switch, E-6t 
/NOVERIFY switch, E-6, E-6t 
operator intervention during 

processing, E-36 
output volume expiration date, 

E-12 

perform, on disk and tape, E-8 
prompt, E-3 

reaccessing devices, E-38 
requirements of SAVE disk, E-8 
RESTORE 

dialogue questions, E-21 

example, E-23 to E-26 

output as system disk, E-23 

processing, E-3 
RESTORE function, E-20, E-21 
run, E-2 

off line, E-2 

on line, E-3 
SAVE Set 

name, E-2 

volume, E-2 
SAVE set, E-2 
short form dialogue, E-7 
/STATS, E-6t 
/STATS switch, E-6 
summary information, E-5 
summary report, E-38 

format, E-39f 

totals, E-40t 
switch types, E-5 
transfer errors, E-49 
use, E-l 

/VERIFY switch, E-6, E-6t 
volume label checking, E-34 
/SCOPE qualifier 

SET TERMINAL command, 8-16 



/SCRATCH switch 

SAVE/RESTORE, E-10 
/SEIZE qualifier 

ALLOCATE command, 11-16 
/SELECT qualifier 

RESTORE command, 16-20 
/SELECT_ERASE qualifier 

SET TERMINAL command, 8-16 
SEND privilege 

BROADCAST command, 6-6 

restricted receiver, 6-6 
Send/receive quota, 5-5 

message, 5-5 

RIB (Receiver ID Block), 5-5 

Send/Receive quotas, 5-1 

Sequential data caching, 11-10, 
11-11 
example, 11-11 

Servers 

assigned to queues, 9-5 

SET ACCOUNT command, 7-16 

SET CACHE command 

/ALL qualifier, 11-18 
/BUFFERS qualifier, 11-19 
/CLUSTERSIZE qualifier, 11-19 
/DATA_MAX I MUM qualifier, 11-20 
/D I RE C TOR Y__MAX I MUM qualifier, 
11-20 

/DISABLE qualifier, 11-20 
/FILE qualifier, 11-18 
/KEEP qualifier, 11-20 
/MAXIMUM qualifier, 11-20 
/NOFILE qualifier, 11-18 
qualifiers, 11-18 
TUNE privilege, 11-18 
SET DATE command, 14-3, 14-31 
SET DEVICE command 

/DISABLE qualifier, 11-2 
/ENABLE qualifier, 11-2 
/NORESTRICT qualifier, 11-2 
/RESTRICT qualifier, 11-2 
SET FILE command, 12-43 
SET FILE/RUNTIME_SYSTEM=name 

command, 12-9 
SET JOB command, 13-19 
SET JOB/HOLD command, 13-6 

SET JOB/RELEASE, 13-6 
SET JOB/PRIORITY command, 13-7 
SET JOB/RUN_BURST command, 13-8 
SET JOB/SIZE command, 13-8 
SET PASSWORD command, 7-20 
SETPAS privilege, 6-6 



Index-23 



SET PRIVILEGE command, 6-1 

SET QUEUE command, 9-37 

SET SERVER command, 9-41 

SET SYSTEM command, 13-21, 14-32 

SET SYSTEM/HOLD command, 14-2 

SET SYSTEM/LOGINS command, 12-20, 

13-2, 13-3 
SET SYSTEM/NOLOGINS command, 13-2 
SET SYSTEM/RELEASE command, 14-2 
SET TERMINAL command, -8-9 
/AUTOBAUD qualifier, 8-1 
/BROADCAST qualifier, 8-8 
dial-up lines, 8-2 
HWCFG privilege, 8-4 
/NOBROADCAST qualifier, 8-8 
/PERMANENT qualifier, 8-7 
START.COM, 8-1, 8-7 
SET TIME command, 14-3, 14-35 
SETPAS privilege 

SET PASSWORD command, 6-6 
Setting job priority, 13-7 
Setting job size, 13-7 
/SETUP qualifier 

SET TERMINAL command, 8-16 
/SHAREABLE qualifier 

INITIALIZE/SERVER command, 9-35 
INSTALL/LIBRARY command, 12-31 
INSTALL/RUNTIME__SYSTEM command, 
12-35 

SET SERVER command, 9-43 
SHOW ACCOUNT command, 7-22 

sample output, 7-24 
SHOW BUFFERS command, buffer 

status report, 12-20 
SHOW BUSY 

use for shutdown, 4-2 
SHOW CACHE command, 11-26 
SHOW COMMAND/SYSTEM command, 

12-16, 12-45 
SHOW DEVICE command, 11-28 
SHOW DISKS 

use for shutdown, 4-2 
SHOW DISKS command 

free space, 14-8 
SHOW FILE/SYSTEM command, 12-46 
SHOW JOB/PRIVILEGE command, 13-22 
SHOW JOBS 

use for shutdown, 4-2 
SHOW JOBS command 

job status, 14-8 
SHOW JOBS/DETACHED command, 14-8 
SHOW LIBRARY command, 12-47 



SHOW LOGICAL/SYSTEM command, 

12-14, 12-49 
SHOW LOGICALS command, 12-48 
SHOW RUNTIME_SYSTEM command, 

12-50 

SHOW SERVER command, 9-44 

SHOW SYSTEM command, 14-9, 14-36 

SHOW TERMINAL command, 8-8, 8-20 

sample output, 8-21 
SHOW USER command 

job control, 13-6 
SHOW USERS command 

job status, 14-8 
Shutdown 

disabling DECnet/E during, 4-5 

ERRCPY, 4-11 

EVTLOG program, 4-11 

final, under SHUTUP, 4-13 

formula for waiting period, 4-6 

manual procedure, A-62 

normal (example), 4-13 

OPSER, 4-10, A-7 

performing system, 4-2 

RSTS/E system, 4-1 

specify waiting period, 4-4 
SHUTUP 

attached jobs, 4-8 

communicate with OPSER, 4-3 

detached jobs, 4-8 

disable DECnet/E, 4-5 

disabling logins, 4-5 

disk dismount phase, 4-12 

EMT logging shutdown phase, 
4-12 

ERRCPY shutdown phase, 4-11 
error message to ERRCPY, 10-4 
example 

DECnet/E shutdown, 4-16 
final job killing phase, 4-12 
final shutdown phase, 4-13 
formula for waiting period, 4-6 
initial job killing phase, 4-8 
limit logins, 4-5 
limit network activity, 4-5 
operational phases, 4-3 
OPSER shutdown phase, 4-10 
perform shutdown with, 4-2 
phases of, 4-2 

removing swapping files, 12-20 
resident library removal phase, 
4-12 

run from console terminal, 4-3 
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SHUTUP (Cont.) 

run with OPSER, 4-3 
run without OPSER, 4-3 
run- time system removal phase, 
4-12 

running QUE MAN after, A-27 
set up dialogue phase, 4-3 
shutdown of DECnet/E, 4-5 
specify shutdown wait period, 
4-4 

swap file removal phase, 4-12 

terminating OPSER, A-7, A-61 

treatment of PBS, 4-8 

unexpected errors, 4-12 

use from KBO : , 4-1 

use of, 2-5 

warning message, 4-6 
SHUTUP example 

large RSTS/E system, 4-13 

small RSTS/E system, 4-15 
SHUTUP privilege 

system control, 6-6 
SIL (Save Image Library) 

format, 12-9 

MAKSIL program, 12-9 
Simulation of hardware errors 

device testing package, F-l 
/SIXEL qualifier 

SET TERMINAL command, 8-17 
/SIZE qualifier 

CREATE/ACCOUNT command, 7-12 

INSTALL/ERROR__FILE command, 
12-29 

INSTALL/OVERLAY_FILE command, 
12-32 

INSTALL/SWAP_FILE command, 
12-37 

SET JOB command, 13-20 
Small buffers 

DISPLY report, 14-24 
FIP, not used for caching, 
11-19 

general (SYSTAT), 14-7 
general, not used for caching, 
11-19 

SHOW BUFFERS command, 14-7 
Small spooler 

see SPL 
Software errors 

logging, 10-1 
/SPECIAL__CHARACTER qualifier 

SET PRINTER command, 11-25 



/SPEED qualifier 

SET TERMINAL command, 8-17 

SPOOL, A-2 

ABORT command, A- 36, A- 48 
/ALIGN switch, A- 51 
ASSIGN option, A-33 
changing NORMAL form, A- 34 
compiled version of, A-29 
default form, A-34 
default keyboard values, A-38 
default line printer values, 
A-37 

/DFLENGTH switch, A- 35 
error handling, A-47 
error messages, A-49 
error text in user output, 

A-50t 
file header, A-48 
FORM command, A- 51 
FORM option, A-34 
forms control characters, A-35 
interrupt commands, A-41, A-41t 
job header, A-48 
line printer errors, A-47 
logical device name, A-30 
modules, A-29 
NAME option, A-34 
NORMAL option, A-34 
/PAGE_E JECT switch, A-35 
PHYSICAL option, A-33 
QUE command, A-48 
raise priority, A-44 
raise run burst, A-44 
REQUE command, A-48 
RESTART command, A-48 
restart queued request, A-48 
run, A-29 
start-up 

error processing, A-39 

examples, A-42 

options, A-31t 
syntax error messages, A-39, 

A-39t 
terminate 

queued request, A-48 

without shutting down, A-61 
Spooling 

determining number of jobs, 
A-25 

initial conditions for, queues, 

A-19 
keyboard, A-38 
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Spooling ( Cont . ) 

line printer, A-37 
Spooling Package Library, A-29 
Spooling programs 

commands, A- 16 

controlling, A-17 

line printer, A-29 

messages, A-16 

monitoring, A-17 

SPOOL, A-29 

SPOOL and BATCH, A- 2 

table of in QUEMAN, A- 5 
Start-up 

BATCH options, A-54t 

BATCH procedures, A- 56 

CCL command definitions, 3-9 

controlling system, 3-1 

SPOOL options, A-31t 

terminal characteristics, 3-9 
Start-up control file 

order of operations, 3-2 
START.COM 

automatic restart, 2-5 

memory image, 2-7 

sample, 3-3 

SET TERMINAL command, 8-1, 8-7 
START.COM file 
ANALYS , 10-30 

commands auxiliary run-time 
system, 12-5 

contents, 3-2 

logical names, 12-12 

replace, 3-2 
START/QUEUE command, 9-46 
START/QUEUE/MANAGER command, 9-47 
START/SERVER command, 9-49 
Statistics 

abbreviations in DISPLY report, 
14-18 

busy device, 14-20 

job status, 14-18 

SAVE/RESTORE run total, E-40t 
STATUS command 

QUEMAN, A- 25 
STOP/QUEUE command, 9-51 
STOP/QUEUE/MANAGER command, 9-52 
STOP/SERVER command, 9-53 
Summary report 

ERRDIS, 10-8 

run totals, E-40t 
Swap file, 1-11 

add, 12-18 



Swap file ( Cont. ) 

affects logins, 12-20 

online creation, 12-19 

removing, 12-18, 12-20 

under SHUTUP, 4-12, 12-20 

SHOW FILE/SYSTEM command, 12-21 
Swap space, 13-3 

restricting logins, 12-20 
SWAP0.SYS file 

allocate and position, 12-18 
SWAP1.SYS file 

allocate and position, 12-18 
SWAP 3 . SYS file 

allocate and position, 12-18 
/SWAP_FILE qualifier 

SHOW FILE/SYSTEM command, 12-46 
Swapping, 1-11 
Swapping mode 

TUNE privilege, 6-8 
SWCFG privilege 

system manager function, 6-6 
SWCTL privilege 

Logins, 6-7 

Network management, 6-7 
SWITCH program 

change keyboard monitor, 1-2 
SY0: 

system disk, 1-3 
SYS functions 

programming, 2-7 
SYSIO privilege 

file access, 6-7 

write access, 6-10 
SYSMOD privilege 

system modification, 6-7 
SYSTAT 

free disk space, 14-8 

guidelines, 14-7 

use, 14-7 
System 

automatic restart RSTS/E, 2-3 

commands, 1-11 

EMT logging to record 

activities, 14-4 
enable data caching, 11-18 
enable directory caching, 11-18 
halt, after bootstrapping 

RSTS/E, 2-3 
halting the RSTS/E, 2-5 
initialization options, 1-4 
initialized in restart mode, 

2-7 
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System ( Cont . ) 

monitoring status, 14-8 
operational concepts, 1-10 
shutdown, 4-1 
start-up, 3-1 

suspending operations, 14-2 
System clock 

DATES privilege, 6-3 
System commands 

INSTAL privilege, 6-5 
System control 

HWCTL privilege, 6-5 

JOBCTL privilege, 6-5 

SHUTUP privilege, 6-6 
System crash, 2-3 

ANALYS program, 3-10 

causes, 2-6 

handling, 2-7 

randomly occurring, 2-6 
System disk, 1-3 

access, 1-4 

contents, 1-5 
System error log, F-l 
System Error Package 

programs, 10-1 
System errors 

compilation, 10-1 

extraction, 10-1 

formatting, 10-1 

retention, 10-1 
System Files 

managing with DCL commands, 
12-lt 
System files 

INSTAL privilege, 6-5 
System logical names 

INSTAL privilege, 6-5 
System manager function 

HWCFG privilege, 6-4 

SWCFG privilege, 6-6 
System modification 

SYSMOD privilege, 6-7 
System programs, 1-3 
/SYSTEM qualifier 

SET PASSWORD command, 7-21 
System restart 

START.COM, 2-7 
System security 

EMT logging, 14-7 
System start-up 

command file, 3-3 

conditions at, 3-1 



System start-up (Cont.) 
controlling, 3-1 
crash recovery, 3-10 



-T- 

/TAB qualifier 

SET PRINTER command, 11-25 
SET TERMINAL command, 8-17 

Tape handling, DCL commands, 
15-lt 

TC11 DECtape operation test 

DTEXER program, F-14 
/TEMPLATE qualifier 

CREATE/ACCOUNT command, 7-12 
TERDFL . SYS 

terminal characteristics, 8-6 
TERMAC . SYS 

terminal characteristics, 8-5 
Terminal 

at system command level, 1-11 

/BROADCAST command qualifier, 
8-7 

CTRL/C typed at, 1-11 
/DFLENGTH switch effect, A- 36 
distinction from line printer, 
A-37 

FORCE command, 13-4 
hardware top of form, A- 39 
line speed characteristics file, 
8-2 

/NOBROADCAST command qualifier, 

8-7 
OSC, A-18 

running SHUTUP from console, 
4-1 

setting characteristics, 8-1 

top of form capability, A-35 
Terminal characteristics 

HWCFG privilege, 8-4 

Start-up, 3-9 

TERDFL. SYS, 8-6 

TERMAC . SYS , 8-5 
Terminal device designator, 8-3 
Terminal line 

dial-up lines, 8-1 

local, 8-1 
TERSPD.SYS file 

account location, 8-2 

/AUTOBAUD qualifier, 8-3 

why create, 8-2 
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/TIME_FORMAT qualifier 

SET SYSTEM command, 14-34 

/TIME_LIMIT qualifier 

INITIALIZE/QUEUE command, 9-33 
SET QUEUE command, 9-40 

Timesharing, start, 2-3 

/TOP_OF__FILE qualifier 

START/QUEUE/MANAGER command, 
9-50 

/TTSYNC qualifier 

SET TERMINAL command, 8-17 
TUNE privilege 

alter base priority, 6-8 

SET CACHE command, 11-18 

swapping mode, 6-8 
/TYPE qualifier 

INS TALL/RUNT I ME_SYSTEM command, 
12-35 

SET TERMINAL command, 8-18 
-U- 

UFD (User File Directory) 
and MFD in Level 0, l-7f 
mark file for caching, 11-11 
reorder, 11-6 

with MFD and GFDs in Level 1, 
l-8f 

/UNLOAD qualifier 

DISMOUNT command, 15-6 
INSTALL/LIBRARY command, 12-31 
INSTALL/RUNTIME_SYSTEM command, 
12-35 

UNLOAD/LIBRARY command, 12-11, 
12-51 

UNLOAD/OVERLAY command, 14-37 
UNLOAD/RUNT I ME_S YS TEM command, 

12-8, 12-52 
/UP_ARROW qualifier 

SET TERMINAL command, 8-18 
Updates 

see also Patches 
/UPPERCASE qualifier 

SET PRINTER command, 11-25 

SET TERMINAL command, 8-18 
User account, 7-2 
User File Directory 

see L7FD 
User interface 

Print/Batch Services (PBS), 9-3 
User job 

area, 1-11 



/USER qualifier 

CREATE/ACCOUNT command, 7-12 
DELETE/ACCOUNT command, 7-15 
SET ACCOUNT command, 7-19 
SHOW ACCOUNT command, 7-23 

User-defined privileges 
USER1-8 privileges, 6-10 

USERl-8 privileges 

User-defined privileges, 6-10 

/USER__DEFINED_KEYS qualifier 
SET TERMINAL command, 8-18 

UTILTY program 
KILL, A-63 



-V- 

/VERIFY qualifier 

BACKUP command, 16-10 

RESTORE command, 16-20 
Volumes 

dismounting SAVE/RESTORE, E-36 
mounting SAVE/RESTORE, E-36 



-W- 

WACNT privilege 

account management, 6-9 
/WIDTH qualifier 

SET PRINTER command, 11-25 

SET TERMINAL command, 8-19 
Window turning 

reducing, 11-14 
Work file 

OPSER stores, A-3 
WREAD privilege 

execute access, 6-9 

read access, 6-9 
Write access 

GWRITE privilege, 6-4 

SYSIO privilege, 6-10 

WWRITE privilege, 6-10 
/WRITE qualifier 

INITIALIZE command, 15-13 
WRTNFS privilege 

non- file - structured I/O, 6-9 
WWRITE privilege 

create access, 6-10 

rename access, 6-10 

write access, 6-10 
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■X- XBUF ( Cont . ) 

resident library allocation, 
XBUF 11-14 
caching allocation, 11-9, 11-11, 
11-13 
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HOW TO ORDER ADDITIONAL DOCUMENTATION 



DIRECT TELEPHONE ORDERS 



In Continental USA 
and Puerto Rico 
call 800-258-1710 



In Canada 

call 800-267-6146 



In New Hampshire, 
Alaska or Hawaii 
call 603-884-6660 



DIRECT MAIL ORDERS (U.S. and Puerto Rico*) 



DIGITAL EQUIPMENT CORPORATION 
P.O. Box CS2008 
Nashua, New Hampshire 03061 



DIRECT MAIL ORDERS (Canada) 



DIGITAL EQUIPMENT OF CANADA LTD. 
940 Belfast Road 
Ottawa, Ontario, Canada K1G 4C2 
Attn: A&SG Business Manager 



INTERNATIONAL 



DIGITAL EQUIPMENT CORPORATION 
A&SG Business Manager 
c/o Digital's local subsidiary 
or approved distributor 



Internal orders should be placed through the Software Distribution Center (SDC), Digital 
Equipment Corporation, Northboro, Massachusetts 01532 



*Any prepaid order from Puerto Rico must be placed 
with the Local Digital Subsidiary: 
809-754-7575 
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Reader's Comments 



Note: This form is for document comments only. DIGITAL will use comments submitted on this form at 
the company's discretion. If you require a written reply and are eligible to receive one under 
Software Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well-organized? Please make suggestions for 
improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 



□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 
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Country 
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